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73 X.21 Library 


The Test Interface Module (TIM) located in the rear of the INTERVIEW determines the 
leads available for monitoring and control (Section 12). The variables and routines in this 
section apply to the X,21 interface module. RS-232, V.35, and RS-449 modules are treated 
in Section 63. 


To use the C variables and routines explained in this section, you must select Buffer Control 
Leads: 428 on the FEB Setup menu. See Section 9. 1(B). If no other source for clock is 
provided, use internal clock (Line Setup menu). Finally, load in the X.21 package via the 
Layer Setup screen. 


The variables and routines approximate X.21 Layer 1 spreadsheet-generated conditions and 
actions. Their use on the Protocol Spreadsheet is not limited to any particular layer, though 
normally they belong at Layer 1. Refer to Section 35 for more detailed explanations of the 
purposes of specific conditions and actions. Sometimes the name of the variable or routine is 
sufficient for identifying its related spreadsheet token. When this is not the case, the 
information is provided below. 


73.1 Structures 


Use the structure xmit_list, shown in Table 73-1, when transmitting line data via the 
x21_transmit_cail routine. Refer to x2/_transmit_call in Section 73.3(A) for an 
example of how to use this structure. 


Table 73-1 
X.21 Structures 


Type Variable Value (hex/decimal) Meaning 
Structure Name: xmit_list Structure of a transmit list for x21_transmit_call 


routine. Declared as type struct. Declared 
automatically if a softkey-entered 
CALL_SETUP_SEND action is taken. Reference 
member varlables of the structure as follows: 
xmit_list.string_length 


unsigned char * string pointer to the location of the transmit etring—the 
transmit string Is dectared separately 
unsigned short string_length O-ftff10-65535 fength of the transmit string 


eed 
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73.2 Variables 


With an X.21 TIM installed, you may monitor the T and R data leads, the C and I 
control leads, and UA. See Table 73-2. 


The fast-event variable fevar_eia_changed detects a change in leads. It does not 
establish which lead(s) has changed, nor the validity of the lead’s status. Two 
associated status variables, current_eia_leads and previous_eia_leads, indicate the 
condition of the leads. These are two-byte (short) variables. Each lead is 
represented by a different bit in the short, Table 73-2 provides the mask that can be 
used to isolate each lead. 


Other bits in these variables monitor the validity of lead status. For the status of a 
lead to be considered valid in X.21, the lead must be stable for a minimum of 16 
bit-times. Each lead’s valid status is indicated by a separate bit in current_eia_leads 
and previous_eia_leads. Again, refer to Table 73-2. 


Whenever a lead changes, the value in current_eia_leads is written to 
previous_eia_leads. Then current_eia_leads is updated. 


(A) Masking To Detect a Change in a Given Lead 


To test whether or not a given lead changed, I for example, while disregarding 
its status, enter the following condition on the Protocol Spreadsheet: 


CONDITIONS: 
{ 


fevar_eia_changed && (((current_eia_leads ~ previous_eia_leads) & 0x40) == 0x40) 


) 


Select a mask value from the list in Table 73-2 to indicate which lead you care 
about. Specify multiple leads with a mask derived via hexadecimal addition. 


The mask for I is 0x40. In the example, the event fevar_eia_changed updated 
current_eia_leads. The new current_eia_leads was bitwise-exclusive~-ORed with 
previous_eia_leads to identify all the leads that changed. Then the result was 
bitwise ANDed with the I mask to determine if I was among the leads that 
changed. If this result was equal to the mask, the lead changed. 


Following the evaluation of the condition, previous_eia_leads was updated to 
match current_eia_leads. 
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Table 73-2 
X.21 Variables 


True when the status changes 
for an EIA lead. Line Setup 
configured for emulate or 
monitor mode. 


C-valid 

B (RS-232 mapping is SQ) 
t-valid (RI) 

R-valld (DSR) 

T-valld (DTR) 


A value In this fist indicates 
which lead(s) you care about. 
When anded (&) with 
current_eia_leads, the result 
equals zero {f the lead is on (or 
the mask If the lead Is off). For 
validity checks, the result of 
anding with current_ela_leads 
equals the mask for valid (or 
zero for invalid}. 


Examples: 


STATE: ¢_on_and_valid 
{ if ((current_ela_leads & 0x81) 
== 1) sound_alarm(); } 


STATE: ¢c_off_and_valld 
{ if ((current_ela_leads & 0x81) 
== 0x81) sound_alarm(); } 


Note: This varlable will store EIA 
status if (1) Interna! or external 
clock Is supplied, {2} ElA leads 
are enabled on FEB Setup, and 
(3) fevar_ela_changed has 
updated the leads. Line Setup 
configured for emulate or 
monitor mode. 


Type Variable Value (hex/decimal) Meaning 
a a 7g SSS? 
extern fast_event fevar_ela_changed 
extern const volatile unsigned short current_ela_lsads 1 

2 

4 

8 

10/16 

40/64 

80/128 

100/256 

200/512 

400/1024 
extern const volatile unsigned short previous_ela_leads 


Same values as 
current_ela_leads. Updated 
when teads change, but only 
after logic has had a chance to 
compare current and previous 
leads. Line Setup configured 
for emulate or monitor mode. 
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(B) Masking For the Status or Validity of a Lead 


You may also test the current status or validity of a lead, independent of any 
change. Ifa mask testing for status is anded with current_eia_leads, zero will 
mean that the lead in on. If the result equals the mask, the lead is off. Ifa 
mask testing for validity is anded with current_eia_leads, the lead status is valid 
when the result equals the mask. If the result is zero, the status is invalid. 


To test for both status and validity, derive a mask via hexadecimal addition. 
And the mask with current_eia_leads, as in this if statement testing for I “on” 
and valid: 


STATE: test_for_t_on_and_valld 


Uf((current_eia_leads & 0x44) == 4} sound_alarm(); 


(C) Detect Change and Current Status 


The two examples shown above could be combined to test for I changing from 
off to valid on: 


CONDITIONS: 


{ 
(fevar_eia_changed && (((current_eia_leads ~ previous_eia_leads) & 0x40) == Oxd0) && 
((current_eia_leads & 0x44) == 4)) 


} 


This example approximates the translator's version of the spreadsheet-token 
condition LEADS | V-ON when it appears alone in a conditions block. When a 
LEADS condition is combined with another condition, in most cases the other 
condition will supply the event variable and only the lead status test will be used. 


73.3 Routines 


(A) Control and Transmit 


Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. 
When you go to the Protocol Spreadsheet and search for errors, a message like 
the following may be displayed: “Error 140: Unresolved reference ctl_eia.” 


ctl_eia 


Synopsis 
extern void ctl_eia(on_mask, off mask); 


unsigned short on_mask; 
unsigned short off_mask; 
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Description 


The cél_eia routine allows you to control the status of the two X.21 control- 
leads. Which lead you control depends on your emulation mode. When the 
Line Setup menu shows Mode: , you control I. An # 
selection gives you control over C. The softkey equivalent of this routine is the 
LEADS action on the Protocol Spreadsheet. 


Inputs 


The first parameter indicates which lead you want to turn on. One bit in the 
parameter controls a given lead: I (01) and C (04). Wherever there is a zero 
in the first parameter, the corresponding lead will be turned on. A one in this 
parameter will not cause any lead to be turned off. A value of Oxff will mean 
don’t care (no action). 


The second parameter indicates which lead you want in the “off” condition. 
One bit in the parameter controls a given Jead: I (01) and C (04). Wherever 
there is a one in the second parameter, the corresponding lead will be turned 
off. Zeroes in this parameter do not turn leads on. A value of 0 will mean 
don't care (no action). 


NOTE: If both bytes are attempting to control the same lead, the 
off parameter will override the on parameter. 


Example 


Suppose your emulate mode is As a DCE, you control the I lead. 
(An attempt to control the status of C will fail, since the DTE controls this 
lead.) When C is raised, you want to turn I on; when C drops, turn I off. 


LAYER: 1 
STATE: controi_| 
CONDITIONS: LEADS C ON 
ACTIONS: 


{ 
ctl_eia(Oxfe, 0x00); 


) 
CONDITIONS: LEADS C OFF 
ACTIONS: 


ctt_eia (Oxff, 0x01); 
} 
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x21_idle_action 


Synopsis 


extern vold x21_idle_action(character); 
unsigned char character; 


Description 


Only for format SYNC, the x2]_idle_action routine allows you to change the 
idle-line condition applied by the INTERVIEW. A LEADS R BELLS action, for 
example, requires the x2/_transmit_call routine in addition to x2/_idle_action. 


Inputs 


The only parameter is a character or numeric value representing the idle 
character. 


Example 


To signal an incoming call, you would use the x2/_transmit_call routine to send 
the sync pattern. Then you would use the x2/_jidle_action routine to send an 
idle string of bells: 


LAYER: 1 


unsigned char syncs {] = {0x16,0x16); 
struct xmlt_list 
{ 
unsigned char * string; 
unsigned short string_length; 
}; 
Struct xmit_list send_string [] = {&synes{0}, 2}; 


STATE: slgnal_Incoming_call 
CONDITIONS: KEYBOARD * " 
ACTIONS: 
‘ 
x2/_transmit_call(!, &send_string{0}, 0); 
“21 _idle_action(’&'); 


} 
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x21_transmit_call 
Synopsis 


extern void x21 _transmit_call(count, struct_send_string_ptr, xmit_tag); 
uhsigned short count; 
struct xmit_list 
{ 
char * string_ptr; 
unsigned short string_tength; 
5 
Struct xmit_lisi * struct_send_string_ptr; 
unsigned short xmit_tag; 


ripti 


The x21]_transmit_cail routine sends a specified data string in call-setup mode. 
The softkey equivalent of this routine is the CALL_SETUP_SEND action. 


Inputs 


The first parameter is the number of strings to be sent. 


The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 


The third parameter is a transmit tag. In other contexts it identifies the type of 
BCC to be sent. In X.21, however, no BCC is sent from Layer 1. The value of 
this parameter should be zero. 


Example 


Assume you are emulating a DTE. To send a call request in call-setup mode, 
enter the following spreadsheet program: 


LAYER: 1 
{ 
unsigned char syncs [}] = {0x16,0x16}; 
unsigned char number [] = “1234567”; 
unsigned char end {] = “t"; 
struct xmit_list 

{ 

unsigned char * string; 

unsigned short string length; 

i 
struct xmit_list send_string (] = {&syncs(0], 2, &number[0}, sizeof(number) - [, &end{0]}, 1}; 
) 
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STATE: send 
CONDITIONS: RECEIVE STRING ‘{S]++" 
ACTIONS: 


{ 
x2!_transmit_call(3, &send_string{0}, 0); 


} 


Notice in the preceding example that sync characters were sent in the same call 
to x2]_transmit_call that sent the called number. The equivalent 
softkey-generated action is LEADS T DATA CALL_SETUP_SEND “% 4 1234567+”. 


x21_transmit_call_idle 
Synopsis 
extern void x21_transmit_call_idle(count, struct_send_string_ptr, xmit_tag, new_idle); 


unsigned short count; 
Struct xmit_list 


{ 
char * string_ptr; 
unsigned short string length; 
}; 
Struct xmit_list * struct_send_string_ptr; 
unsigned short xmit_tag; 
unsigned char new_Idle; 


ripti 


The x2/_transmit_call_idle routine sends a data string in call-setup mode and 
includes a specified idle character. The softkey equivalent of this routine is the 
CALL_SETUP_SEND_IDLE action. This routine differs from x2/_transmit_call in 
that a change in idle character is guaranteed to occur during the transmission. 


Inputs 


The first parameter is the number of strings to be sent. 


The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 


The third parameter is a transmit tag. In other contexts it identifies the type of 
BCC to be sent. In X.21, however, no BCC is sent from Layer 1. The value of 
this parameter should be zero. 


The fourth parameter is the idle character. Enter the idle character as a 
decimal or hexadecimal value, or as a character enclosed by single quotes (‘’). 


Example 


This example is the same as the one for x2/_transmit_call except that here the 
idle character, +, is included in the call to x2/_transmit_call_idle. 
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LAYER: 1 


{ 

unsigned char synes [{} = {0x16,0x16}; 
unsigned char number [{] = “1234567”; 
Struct xmit_list 


{ 
unsigned char * string; 
unsigned short string length; 
s 
Struct xmit_list send_string [] = {&syncs{O}, 2, &number{0], sizeof(number) - 1}; 


} 
STATE: send 


CONDITIONS: RECEIVE STRING ‘{5]++” 
ACTIONS: 


{ 
x2/_transmit_cail_idie(2, &send_string{0], 0, 0x26); 


) 


Notice in the example that sync characters were sent in the same call to 
x21_transmit_call_idle that sent the called number. The equivalent 
softkey-generated action is CALL_SETUP_SEND IDLE “% 1234567" NEW_IDLE “+”. 


set_tcr_b 


Synopsis 


extern void set_ter_b (tcr_register_mask, ter_register_vatue); 
unsigned char tcr_register_mask; 
unsigned char tcr_register_value; 


Description 

This routine clamps the transmit line to 0 (space) or 1 (mark), or unclamps it so 
that transmit routines may be executed. In X.21, steady zero will signal a clear 
request/indication or a clear confirm, while steady 1 will indicate one of the 
call-ready or caill-setup states. 


The X.21 softkey actions that are built on this routine are LEADS R (T) ONE, 
LEADS R (T) ZERO, and LEADS R (T) DATA. In other contexts, the routine simply 
initiates and terminates a break. 


Inputs 


The first parameter is the mask that is anded with the current TCR register to 
turn the current values of bits 3 and 4 (counting 1-8 from the right) to zero. 
This mask is always 0xf3. 


The second parameter contains the new values of bits 3 and 4 that will be 
written to the register. The three available parameters are 0x08 to clamp the line 
to zero, O0x0c to clamp the line to 1, and 0x04 to unclamp the line and permit 
data transmissions. 
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Example 


Assume you are emulating a DTE. To indicate a clear confirmation, enter the 
following spreadsheet program: 


LAYER: 1 
STATE: 
CONDITIONS: KEYBOARD * * 
ACTIONS: 


{ 
Set_ter_b (Oxf3, 0x08); 
etl_eia(Oxff, 0x04); 


The equivalent softkey-generated action is LEADS T ZERO C OFF. 


(B) Phase 


The following routines are valid in either emulate or monitor mode. 


enter_call_phase 


Synopsis 


extern void enter_cail_phase(); 


Description 


During the call-establishment phase, this routine overrides existing selections on 
the Line Setup menu with ASCII code, 7-bit odd parity, and SYNC format. 


Example 


When a lead changes, look for these conditions: T and R on (space), C and I 
off, and all leads valid. If conditions are true, enter call phase. 


{ 
extern fast_event fevar_ela_changed; 
extern const volatile unsigned short current_eia_leads; 


} 
LAYER: 1 
STATE: look_for_change_to_call_phase 
CONDITIONS; 


{ 
fevar_ela_changed && ((current_eia_leads & Ox5dd) == Oxdd)} 


} 
ACTIONS: 
{ 


enter_call_phase(); 


) 
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enter_data_phase 
Synopsis 


extern vold enter_data_phase(); 


Description 


During the data-transfer phase, this routine implements existing selections on the 
Line Setup menu. 


Example 


When a lead changes, look for these conditions: T and R off (mark), C and I 
on, and all leads valid. If conditions are true, enter data phase. 


{ 
extern fast_event fevar_eia_changed; 
extern const volatile unsigned short current_ela_leads; 


) 
LAYER: 1 
STATE: fook_for_change_to_data_phase 
CONDITIONS: 
{ 
Jevar_eia_changed && ((current_eia_leads & Oxidd) == Ox5!d) 
) 
ACTIONS: 
{ 
enter_data_phase(); 


} 
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74 X.25 Layer 2 Library 


When the X.25 Layer 2 package is loaded in via the Layer Setup screen, the following 
externa] routines and variables become- available for use by the programmer. Their use on 
the Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 


The variables and routines approximate X.25 Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 36 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 


74.1 Structures 


The structure send_frame_struciure defines the format of transmitted X.25 frames, 
See Table 74-1. Use this structure to send frames via the send_frame routine in 
emulate mode. See Section 74.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 


74.2 Variables 


(A) Monitoring Events 


1. Emulate or monitor mode, X.25 Layer 2 events include frames detected, 
good or bad BCC's, and aborts. All event variables in Table 74-2 containing 
a dte_ or dce_ prefix are valid in either emulate or monitor mode. These 
event variables are dte_frame, dce_frame, dte_good_bcc, dce_good_bcc, 
dte_bad_bec, dce_bad_bcc, dte_abort, dce_abort. The variable 
dce_good_bce, for example, equates to DCE GDBCC, 


You can use both dfe and dce variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 


CONDITIONS: 
die_bad_bcc || dce_bad_bee 


} 
ACTIONS: COUNTER bad_bec INC 
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Table 74-1 
X.25 Layer 2 Structures 


Type Variable Value (hex/decimal) Meaning 
Structure Name: send_frame_structure Structure of a frame In X.25. Declared as type 


struct. Declared automatically tf a 
softkey-entered SEND action Is taken. Program 
frames assigned to structure as follows: struct 
send_frame_structure name. Reference a 
structure varlable as follows: name.bec_type. If 
values In the frarne structure are not initialized by 
the user, they default to G0. You may Initlallze the 
values when the structure ts declared: 

struct send_frame_structure name = {1, 1, 1, 0, 
1.1, 3, 0x71, 3, O}; 


unsigned char addr_type 0 command 
1 response 
2 other 
unsigned char frame_type (The codes for frame_type are the same as for 
the X,25-varlable rcvd_frame_type.) 
unsigned char nr_type 0 auto 
1 value 
2 recelved ns plus 1 
3 fast nr sent 
unsigned char : ns_type 0 - auto 
: 1 skip 
2 last nr recelved 
3 value 
unsigned char p_f_type 0 0 s 
1 1 
2 toopback 
unsigned char bec_type 0 default {bad bec) 
1 good bce 
2 bad bec 
3 abort 
unsigned char addr_value t to DCE 
3 to DTE 
unsigned char cntrt_byte (actual Value of the control byte) 
unsigned char nr_value 0-7 (MOD &) If nr_type = 1 
unsigned char ns_value 0-7 (MOD 8) if ns_type = 3 


aera ee eee esn eneeee n eee eeee 
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Table 74-2 
X.25 Layer 2 Variables 


Type Variable Value (hex/decimal) Meaning 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 
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dte_frame 


dce_frame 


dte_good_bce 


dce_good_bec 


dte_bad_bce 


dce_bad_bce 


dte_abort 


dce_abort 


revd_frame 


Invalid_frame 


12TH 


bec_error 


nr_error 


ns_error 


True when a DTE frame is 
detected. Line Setup 
configured for emulate or 
monitor mode. 


True when a DCE frame Is 
detected. Line Setup 
configured for ernulate or 
monitor mode. 


True when a good BCC is 
calculated for a OTE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a good BCC Is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a bad BCC Is 
calculated for a OTE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a bad BCC is 
calculated for a DCE frame. 
Line Setup contigured for 
emulate or monitor mode. 


True when an abort Is detected 
for a DTE frame. Line Setup 
configured for emulate or 
monitor mode. 


True when an abort Is detected 
for a DCE frame. Line Setup 
configured for emulate or 
monitor mode. 


True when a frame is recelved. 
Line Setup configured for 
emulate mode only. 


True when an Invalid frame Is 
detected, Line Setup 
conflgured for emulate mode 
only. 

True when the T1 timeout-timer 
has expired. Line Setup 
configured for emulate mode 
only. 

True when a BCC error Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when an N(R) error Is 
detected In a received INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

True when an N(S) error Is 
detected In a received INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 74-2 (continued) 


Type Variable Value (hex/decimal) Meaning 


extern event frame_sent True when frame Is passed 
down to Layer 1. Line Setup 
configured for emulate mode 


only. 
extern volatlla const unsigned char m_frame_addr 1 to DCE 
3 to DTE 


Line Setup configured for 
emulate or monitor mede, 


extern volatile const unsigned char m_frame_type (same as revd_frame_type—Line Setup 


configured for emulate or monitor mode) 
extern volatile const unsigned char m_frame_ecntri_byte_1 (actual value of contro! byte—Line Setup 

configured for emulate or monitor mode) 
extern volatile const unsigned char m_frame_pf 0 pf=0 

10/16 pf=1 


Line Setup configured for 
emulate or monitor mode. 


extern vofatile const unsigned char m_frame_bec_type 1 good 
2 bad 
3 abort 


Line Setup conflgured for 
emulate or monitor mode. 


extern volatile const unsigned char revd_frame_adar 1 to DCE 
3 to DTE 


Line Setup configured for 
emulate mode only. 


extern volatile const unsigned char revd_frame_type 0 info 
1 tr 
5 ror 
9 re} 
d/13 sre} 
2f/47 sabm 
6f/111 sabme 
43/67 disc 
#/15 dm 
€/15 sarm 
63/99 ua 
87/135 frmr 
ff/255 other 
£#/255 unknown 
Line Setup configured for 
emulate mode only. 
extern votatile const unsigned char revd_frame_cntril_byte_1 (actual value of control byte—Line Setup 
configured for emulate mode only) 
extern volatiie const unsigned char revd_frame_pf 0 pf=0 
10/16 pf=1 
Line Setup configured for 
emulate mode only. 
extern volatile const unsigned ohar rovd_frame_bec_type 1 gos 
2 a 
3 abort 


Line Setup configured for 
emulate mode only. 


extern volatile const unsigned char revd_frame_nr 0-7 (MOD 8) LIne Setup configured for 
emulate mode only. 
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Table 74-2 (continued) . 


Type Variable Value (hex/decimal) Meaning 
extern volatile const unsigned char rovd_frame_ns 0-7 (MOD 8) Line Setup configured for 
emulate mode only. 
extern volatile unsigned short revd_frame_buff_seg Inter-layer message buffer 


number (actually, an |APX-286 
sagment number) in a recelved 
frame. This segment number 
can be converted to a pointer 
by shifting it left 16 bits, Line 
Setup configured for emulate 
mode only. 


extern volatile unsigned short revd_frame_sdu_offset Offset to where the service data 
unit begins In an Inter-layer 
message buffer In a recelved 
frame. Add to buffer segment 
number {converted to polnter) 
to point to first byte In frame. 
Line Setup configured for 
emulate mode only. 


extern volatile unsigned short rovd_frame_sdu_size Size of service data unit ina 
recelyed frame. Line Setup 
configured for emulate mode 
only. 


extern volatile unsigned short I2_current_window_edge When equal to upper edge, 
window Is full; when equal to 
tower edge, window Is empty: 
when not equal to upper edge, 
‘window {ts not full; and when not 
equal to tower edge, window Is 
not empty. Line Setup 
configured for emulate mode 


only. 
extern volatile unsigned short I2_lower_window_edge see |2_current_window_edge 
extern volatile unsigned short I2_upper_window_edge see [2_current_window_edge 
extern volatile unsigned short 12_resend_edge When resend edge Js not equal 


to lower window edge, there is 
more to resend: when resend 
edge Is equal to jower window 
edge, there is no more to 
resend. Line Setup configured 
for emulate mode only. 


extern unsigned char I2_enhance 0 normal 

1 reverse 

4 low 

5 reverse low 

8 biInk 

9 reverse blink 

12/18 blink low 
Line Setup configured for 
emulate or monitor mode. 


extern unsigned char J2_suppress off 
on 


Line Setup configured for 
emulate or monitor mode. 
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Using spreadsheet tokens, the same test-needs two CONDITIONS/ACTIONS 
blocks: 


CONDITIONS: DTE BDBCC 
ACTIONS: COUNTER bad_beoo INC 
CONDITIONS: DCE BDBCC 
ACTIONS: COUNTER bad_bee INC 


When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 


{ 
dte_frame && (m_frame_type == 0) 


As a C programmer, you do not need to specify a frame type. To include 
all frames in a condition, use the event variable only: 


CONDITIONS: 


{ 
dte_frame 


} 


2. Emulate mode only. Some events may be detected in emulate mode only. 
The event variables are rcvd_frame, invalid_frame, 12_T1, bcc_error, 
nr_error, ns_error, and frame_sent. 


If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_frame.” 


When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 


{ 
revd_frame && (revd_frame_type == 0) 


The C programmer does not have to specify a frame type. To include all 
received frames in a condition, use the event variable only: 


CONDITIONS: 
{ 


revd_frame 


} 


Error detecting may be accomplished via bec_error, nr_error, ns_error, and 
invalid_frame. These variables equate to the softkey tokens bearing similar 


names. 
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One of the emulate-mode variables monitors an emulate action. The event 
variable frame_sent will come true as soon as the frame has been passed to 
the layer below. Note that if Layer 1 is an X.21 protocol in call-setup 
phase, a frame that is “sent” at Layer 2 will stop at Layer 1 and will not be 
transmitted out onto the line. 


(B) Status Variables 


Status variables are those in Table 74-2 that do not include event in the Type 
column. Their associated. event variables. guarantee that they are updated and 
tested. 


The softkey-generated condition for received Info frames is RCV INFO. The C 
version of the same condition should look like this: 


CONDITIONS: 


{ 
revd_frame && (rcvd_frame_type == 0) 
) 


1. Frame characteristics. Alt status variables in Table 74-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m_frame_adadr, 
m_frame_type, m_frame_cntrl_byte_l, m_frame_pf, and m_frame_bcc_type. 
Use these variables to monitor a particular address, frame type, control byte, 
P/F value, or BCC. 


All status variables in Table 74-2 containing a rcvd_ prefix are valid in 
emulate mode only: rcvd_frame_addr, rcvd_frame_type, 
rcvd_frame_cntrl_byte_l, revd_frame_bcc_type, revd_frame_pf, 
revd_frame_nr, and rcvd_frame_ns. Use these variables to monitor a 
particular address, frame type, control byte, BCC, or P/F, N(R), or N(S) 
value. 


If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_frame_type.” 


2. Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd_frame_buff_seg, 
revd_frame_sdu_offset, and revd_frame_sdu_size. See Section 66.1 for a 
more detailed discussion of the buffer components to which these variables 
refer. 
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Make a pointer to an IL buffer by casting revd_frame_buff_seg as a long, 
shifting it left sixteen bits, adding rcvd_frame_sdu_offset, and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset). 


{ 

unsigned char * ptr; 

ptr = {vold *}(({long)revd_frame_buff_seg << 16) + revd_frame_sdu_offset); 
ptrt=2; 


} 


It is now pointing at the first byte in the X.25 Layer 3 header. You may 
continue to move through the frame for its entire length, indicated in 
revd_frame_sdu_size. 


3. Transmit window. Four related variables test the status of the Layer 2 
window. The particular values of these variables at any given time is not 
significant. What is significant is how they compare to each other. The 
softkey status condition on the left makes the variable comparison on the 


right: 

WINDOW FULL i2_current_window_edge == I2_upper_window_edge 
WINDOW EMPTY 12_current_window_edge == 12_lower_window_edge 
WINDOW NOT_FULL 12_current_window_edge != (2_upper_window_edge 
WINDOW NOT_EMPTY 12_current_window_edge != !2_lower_window_edge 
MORE_TO_RESEND 12_resend_edge {= 12_lower_window_edge 


NO_MORE_TO_RESEND i2_resend_edge == 12_lower_window_edge 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /2_enhance or I2_suppress. 
The values are listed in Table 74-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
frames in reverse-video and suppress display of invalid frames: 


CONDITIONS: RCV RNR 
ACTIONS: 
{ 


i2_enhance = 1; 


} 
CONDITIONS; RCV INVALID 
ACTIONS: 


{ 


12_suppress = 1; 


} 
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Check the value of these display-contro! variables in a CONDITIONS block 


CONDITIONS: RCV INFO 
{ 


i2_enhance == 
) 
ACTIONS: 


{2_enhance = 0; 


} 
or an ACTIONS block: 


CONDITIONS: RCV INFO 

ACTIONS: 

{ 

if(12_enhance == 1} 
i2_enhance = 0; 


} 


74.3 Routines 
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Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following may be displayed: “Error 140: Unresolved reference 12_give_data.” 


(A) Receive 
I2_give data 
Synopsis 


extern void 12_give_data(}; 


Description 


The /2_give_data routine takes an interlayer message buffer associated with a 
received INFO frame, changes the SDU offset to point to. higher-level data, and 
sends a DL_DATA IND primitive up to Layer 3 along with a reference to this 
buffer. The softkey equivalent of this routine is the GV_DATA action on the 


Protocol Spreadsheet. 


Example 


Layer 3 wants access to the line in order to receive and send data. Assuming 
X.25 personality packages are loaded at Layers 2 and 3, enter the following 
program: 
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LAYER: 2 
STATE: datalink 

CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “(€DL_DATA))” 
CONDITIONS: RCV INFO 
ACTIONS: 


{2_glve_data(); 


(B) Transmit 


resend_frame 


Synopsis 


extern void resend_frame(pf, first_or_next); 
unsigned char pf; 
unsigned char first_or_next; 


Description 


The resend_frame routine will set the P/F bit to a specified value and resend 
either the first or next frame in the window. The softkey equivalent of this 
routine is the (PROTOCL) RESEND action on the Protocol] Spreadsheet. 


Inputs 


The first parameter is the value of the P/F bit in the frame. It may be set to 
either 0 or 1. 


The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or, next 
has been selected. Legal entries are 0 (first) or 1 (next). 


Example 
Suppose you want to resend the entire transmit window if you receive a REJ 
frame. 
LAYER: 2 
STATE: xfer 


/* Whatever conditions and actions send data precede the following condition. */ 


CONDITIONS: RCV REJ RESP 
NEXT_STATE: recover 
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STATE: recover 
CONDITIONS: ENTER_STATE 
ACTIONS: 


resend_frame(I, 0); 


} 

CONDITIONS: FRAME_SENT 
MORE_TO_RESEND 

ACTIONS; 


{ 
resend_frame(1,1)}; 


} 

CONDITIONS; FRAME_SENT™ 
NO_MORE_TO_ RESEND 

NEXT_STATE: xfer 


reset_nr 


Synopsis 

extern void reset_nr(); 

Description 

This routine resets the N(R) field in information and supervisory frames to zero. 


The softkey equivalent of this routine is the (PROTOCL) RSET_NR action on the 
Protocol Spreadsheet. 


Example 
When a link is established, reset N(R). 


LAYER: 2 
STATE: reset 
CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV VA 
ACTIONS: 


{ 


reset_nr(); 


} 


reset_ns 
Synopsis 

extern void reset_ns(); 
Description 


The N(S) field in information frames is reset to zero and the transmit window is 
cleared. The softkey equivalent of this routine is the (PROTOCL) RSET_NS action 


on the Protocol Spreadsheet. 
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Example 
When a link is established, reset N(S). 


LAYER: 2 
STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 
{ 
resei_ns(); 


} 


send_frame 


Synopsis 


extern void send_frame(il_buffer_number, relay_baton, data_start_offset, transmit_frame_ptr); 
unsigned short il_buffer_number; 

unsigned shori relay_baton; 

unsigned short data_start_offset; 

struct send_frame_Structure 


{ 

unsigned char addr_type; 
unsigned char frame_type; 
unsigned char nr_type; 
unsigned char ns_ftype; 
unsigned char p_f_type; 
unsigned char bec_type; 
unsigned char addr_value; 
unsigned char cntri_byte; 
unsigned char nr_value; 
unsigned char ns_value; 


} 
Struct send_frame_structure * transmit_frame_ptr; 


Description 

The send_frame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 

Inputs 


The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 


The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66.3(A). 


The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). 
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The fourth parameter is a pointer to the frame. structure to be sent. For a 
description of send_frame_structure, see Table 74-1.. 


Example 


Send an Info frame containing a canned fox message and a good BCC onto the 
line. 


{ 
Static unsigned short il_buffer_number; 
Static unsigned short relay_baton; 
Static unsigned short data_start_offset; 
Struct send _frame_structure 
C 
unsigned char addr_type; 
unsigned char frame_type; 
unsigned char nr_type; 
unsigned char ns_type; 
unsigned char p_f type; 
unsigned char bec_type; 
unsigned char addr_vatue; 
unsigned char cntrl_byte; 
unsigned char nr_vatue; 
unsigned char ns_vatue; 
s 
Struct send_frame_structure transmit_frame; 
Stati¢ char transmit_string [{] = “(FOX)”; 
} 
LAYER: 2 
STATE: send_a_frame 
CONDITIONS: KEYBOARD “ ” 
ACTIONS: 
{ 
_get_il_ msg buff(&il_buffer_number, &relay_baton); 
_Start_il_buff_list(il_buffer_number, &data_start_offset); 
transmit_frame.bec_type = 1; 
_lusert_il_buff_list_ent(il_buffer_number, data_start_offset, &transmit_string{0}, 
(sizeof(transmit_string) - 1)}; 
send _frame(il_buffer_number, relay_baton, data_start_offset, &transmit_frame); 


} 
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When the X.25 Layer 3 package is loaded in via the Layer Setup screen, the following 
external routines and variables become available for use by the programmer. Their use on 
the Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 3. 


The variables and routines approximate X.25 Layer 3 spreadsheet-generated conditions and 
actions, Refer to Section 37 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 


75.1 Structures 


The send_packet_structure defines the format of transmitted X.25 packets. See 
Table 75-1. Use this structure to send packets via the send_packet routine in 
emulate mode. See Section 75.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 


75.2 Variables 


(A) Monitoring Events 


1. Emulate or monitor mode. Two X.25 Layer 3 event variables are valid in 
either emulate or monitor mode. These event variables are dte_packet and 
dce_packet. 


When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
packet type. A OTE DATA condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 


{ 
dte_packet && (m_packet_type == 0) 


} 
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Table 75-1 
X%.25 Layer 3 Structures 


Type Variable Value (hex/decimal) Meaning 


Structure of a packet [n X.25. Declared ae type 
struct. Declared automatically If a 
softkey-antered SEND action Is taken. Program 
packets assigned to structure as follows: struct 
send_packet_structure name. Reference a 
structure variable as follows: name.q_bit. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may initlallze the 
values when the structure Is declared: 

struct send_packet_structure name = {2, 0x13, 
0x13, 0,0, 0, 1,0,0,0,1,1, 0,0, 2, 
&facilities_string[0}, 0, 0}; 


Structure Name: send_packet_structure 


path_num 0-8 : path number 
{6/254 use path number of last received packet 


(The codes for packet_type are the same as for the X.25-varlabie 
m_packet_type.) 
(actual value of the packet type byte) 


unsigned char 
unsigned char packet_type 


unsigned char packet_type_byte 


unsigned char m_bit 0 m=0 

1 m= 
unsigned char d_bit 0 d=0 

40/64 d=1 
unsigned char q_bit 0 q=90 

80/128 q=1 
unsigned char pr_type 0 auto 

1 value 

2 recelved ps plus 1 

3 last pr sent 
unsigned char ps_type 0 auto 

1 skip 

2 received pr 

3 value 
unsigned char pr_value 0-7 (MOD 8) If pr_type = 1 
unsigned char ps_value 0-7 (MOD 8) if ps_type = 3 


unsigned char cause (value of cause byte—see Figure 36-15) 

unsigned char diag_flag 0 diagnostlo fleld not present 
1 diagnostic fleld Is present 

unsigned char diag (value of diagnostic byte—consult CCITT Recommendation X. 25, 
pp. 237-8) 

unsigned char spare 0 reserved space 

unsigned char facliitles_len 0-ff/0-255 length of the faoliitles fleld 

char * facllitles pointer to the location of the facilitles fleld—the 

facilitles field is declared separately 
unsigned short data_len reserved for future use 
char * data reserved for future use 


eee ee ee ene e a ee eer ene —— 


JUL '90 


7§_ X.25 Layer 3 Library 


X.25 Layer 3 Varlables 


Type 


Variable 


Value (hex/decimal) 


Meaning 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern volatile unsigned short 


extern volatile unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 
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dte_packet 
dce_packet 
revd_packet 
Invalid_packet 


pr_error 


ps_error 
packet_sent 


m_packet_icn 


m_packet_Icn_grp 


m_packet_q 


m_packet_d 


m_packet_m 


m_packet_pr 


m_packet_ps 


0-f1110-4095 


0-f10-15 


0 
80/128 


40/64 


10/16 


0-7 (MOD 8) 


0-7 (MOD 8) 


True when a DTE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 


True when a DCE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 


True when a packet is recelyed 
from Layer 2. Line Setup 
configured for emulate mode 
only, 


True when an Invalid packet ts 
detected. Line Setup 
configured for emulate mode 
only. 


True when an P(R) error Is 
detected In a data or 
supervisory packet. Line Setup 
configured for emulate mode 
only. 


True when an P(S) error Is 


‘detected in a data packet. Line 


Setup configured for emulate 
mode only. 


True when a packet has been 
passed down to Layer 2. Line 
Setup configured for emulate 

mode only, 


Logleal channel number. Line 
Setup conflgured for emulate or 
monitor mode. 


Logleal channel group number. 
Line Setup configured for 
emulate or monitor mode. 


q=0 
q=1 
Line Setup configured for 
emulate or monitor mode. 
d=0 
d=1 
Line Setup configured for 
emulate or monitor mode. 
m=0 
m=1 
Line Setup configured for 
emulate or monitor mode, 
Line Setup configured for 
emulate or monitor mode. 


Line Setup configured for 
emulate or monitor mode. 
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Table 75-2 (continued) 


Type 


Variable 


Value (hex/decimal) 


Meaning 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile unsigned short 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


m_packet_cause 
m_packet_diag_code 
m_packet_type_byte 


m_packet_type 


revd_pkt_Icn 


rovd_pkt_g 


rovd_pkt_d 


rovd_pkt_m 


tovd_pkt_pr 
rovd_pkt_ps 
revd_pkt_cause 


revd_pkt_diagn 


(same as revd_pkt_cause—Line Setup 
configured for emulate or monitor mode) 


(same as revd_pkt_diagn—Line Setup 
configured for emulate or monitor mode) 


(actual value of packet type byte—Line Setup 
contigured for emulate or monitor mode) 


b/ti 
f/15 
13/19 
17/23 
0 
23/35 
27/39 
1 

5 

9 
1b/27 
1f/31 
10/251 
ff/255 
1/241 
(3/243 
7/247 
11/17 
WW/17 


O-fff10-4095 


0 
80/128 


0-7 (MOD 8) 


0-7 (MOD 8) 


call 

call acc 
clear 
clear conf 
data 

Int 

Int conf 

rr 

ror 

re} 

reset 
reset conf 
restart 
restart conf 
dlag 

reg 

reg conf 
other pkt 


“unknown pkt 


Line Setup configured for 
emulate or monitor mode. 


Logical channel number In a 
recelved packet. Line Setup 
configured for emulate mode 
only. 

q=0 

q=1 

Line Setup configured for 
emulate mode only. 

d=0 

d=1 

Line Setup configured for 
emulate mode only, 

m=0 

m=1 

Line Setup configured for 
emulate mode only. 

Line Setup configured for 
emulate mode oniy. 


Line Setup configured for 
emulate mode only. 


(see Figure 36-15—Line Setup configured for 
emuiate mode only) 


(consult CCITT Recommendation x. 25, 
pp.237-8—Line Setup configured for emulate 


mode only) 
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Table 75-2 (continued) 


Type 


Variable 


Value (hex/decimal) Meaning . 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern Volatile unsigned short 


extern volatile unsigned short 
extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 
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rovd_pkt_type_byte 


rovd_packet_type 


m_packet_buff_seg 


m_packet_Info_seg 
m_packet_sdu_offset 


m_packet_Info_offset 


m_packet_length 


m_packet_Info_length 


(actual value of packet type byte~—Line Setup 
configured for emulate mode only) 


b/11 
£/15 
13/19 
17/23 
0 
23/35 
27/39 
1 

5 

9 
1b/27 
1f/31 
{b/251 
4/255 
#1/241 
3/243 
7/247 
41/17 
11/17 


oall 

call aco 
clear 

clear conf 
data 

Int 

Int conf 

rr 

ror 

re} 

reset 

reset conf 
restart 
restart conf 
diag 

reg 

reg conf 
other pkt 
unknown pkt 


Line Setup configured for 
emulate mode only. 


Inter-layer message buffer 
number (actually, an [APX-286 
segment number). This 
segment number can be 
converted to a pointer by 
shifting It teft 16 bits. Line 
Setup configured for emulate or 
monitor mode. 


Same as m_packet_buff_seg. 


Offset to where the service data 
unlt begins In an Inter-layer 
message buffer. Add to 
m_pkt_buff_seg (converted to 
pointer) to point to first 
packet-header byte. Line Setup 
configured for emulate or 
monitor mode. 


Offset to where the packet 
Information begins, excluding 
the header. Add to 
m_pkt_buff_seg (converted to 
polnter) to point to packet data. 
Line Setup configured for 
emulate or moniter mode. 


Length of the packet, including 
header. Line Setup configured 
for emulate or monitor mode. 


Length of the packet 
Information, excluding the 
header. Line Setup configured 
for emulate or monitor mode. 
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Table 75-2 (continued) 


Type Variable Value (hex/decimal) Meaning 


extern volatile unsigned short revd_pkt_buff_seg Inter-layer message buffer 
number {actually, an JAPX-286 
segment number) In a recelved 
packet. This segment number 
can be converted to a pointer 
by shifting it left 16 bits. Line 
Setup configured for emulate 


mode only, 
extern volatile unsigned short revd_pkt_info_seg Same as rcvd_pkt_buft_seg. 
extern unsigned short revd_pkt_sdu_offset Offset to where the service data 


unit begins In an inter-layer 
message buffer In a packet 
received, Add to 
rovd_pkt_buff_seg (converted to 
pointer) to polnt to first 
packet-header byte. Line Setup 
configured for emulate mode 
only. 


extern volatile unsigned short revd_pkt_Info_offset Offset to where the packet 
Information begins, excluding 
the header. Add to 
revd_pkt_buff_seg (converted to 
polnter} to point to packet data. 
LIne Setup configured for 
emulate mode only. 


extern unsigned short revd_pkt_length Length of a received packet, 
Including header Information. 
Line Setup configured for 
emulate mode only. 


extern volatile unsigned short rovd_pkt_Info_length Length of the Information in a 
received packet, excluding the 
header, Line Setup configured 
for emulate mode only. 


extern volatile unsigned char * m_packet_ptr Pointer to the packet, beginning 
at the firet byte In the header, 
Line Setup configured for 
emulate or monitor mode. 


extern volatile unsigned char * m_packet_info_ptr Pointer to the information in a 
packet. Initially polnts to the 
byte immediately following the 
packet-type byte. Line Setup 
contigured for emulate or 
moniter mode. 


extern volatile unsigned char * rovd_packet_ptr Polnter to the packet, beginning 
at the first byte in the header. 


LIne Setup configured for 
emulate mode only. 


extern volatile unsigned char * revd_pkt_Info_ptr Pointer to the packet 
information, Initially tocated at 


the byte Immediately following 
the packet header. Line Setup 
configured for emulate mode 
only, 
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Table 75-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile const unsigned char revd_device_path Path number connecting 


extern unsigned char 


extern unsigned char 


recelved packet to particular 
LCN and particular set of call 
parameters on the X.25 Packet 
Level Setup screen. Line Setup 
configured for emulate mode 
only. 


I3_enhance 0 normal 

1 reverse 

4 low 

5 reverse low 

8 blink 

9 reverse blink 

12/18 blink low 
Line Setup configured for 
emulate or monitor mode. 


(3_ suppress 0 off 
1 on 


Line Setup configured for 
emulate or monitor mode. 
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A C programmer does not have to specify a packet type. To include all 
packets in a condition, use the event variable only: 


CONDITIONS: 


{ 
dte_packet 


} 


Emulate mode only. Some events may be detected in emulate mode only. 
These are rcvd_packet, invalid_packet, pr_error, ps_error, and packet_sent. 


If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_packet.” 


When the user selects RCV on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
packet type. When the translator converts a RCV DATA condition into C, it 
will include two C variables, one event variable and one status variable: 


{ 
revd_packet && (revd_packet_type == 0) 


} 


As a C programmer, you do not have to specify a packet type. To include 
all received packets in a condition, use the event variable only: 


CONDITIONS: 


{ 
revd_packet 


} 
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Error detecting may be accomplished via pr_error, ps_error, and 
invalid_packet. These variables equate to the softkey tokens bearing similar 
names. 


One of the emulate-mode variables monitors an emulate action. “SEND” ing 
a packet means queuing a packet to be passed down to Layer 2. If the 
Layer 2 link is not established, for example, the packet will be held at Layer 
3 pending link establishment. The event variable packet_sent will not come 
true until the packet actually has been passed to the layer below. Use this 
condition to start accurate response-time measurements at the packet level 
rather than at the line level. - 


(B) Status Variables 


Status variables are those in Table 75-2 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for received Data packets is RCV DATA. The C 
version of the same condition should look like this: 


CONDITIONS: 


{ 
revd_packet && (revd_packet_type == 0) 


( 
1. Packet characteristics. All status variables in Table 75-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m_packet_Icn, 
m_packet_Icn_grp, m_packet_q, m_packet_d, m_packet_m, m_packet_pr, 
m_packet_ps, m_packet_cause, m_packet_diag_ code, m_packet_type, and 
m_packet_type_byte. 


All status variables in Table 75-2 containing a rcvd_ prefix are valid in 
emulate mode only: revd_pkt_len, revd_pkt_q, revd_pkt_d, rcvd_pkt_m, 
revd_pkt_pr, revd_pkt_ps, rcvd_pkt_cause, revd_pkt_diagn, rcvd_pkt_type, 
and rcvd_pkt_type_byte. 


If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_packet_type.” 


2. Packet buffers. Packets are passed up to Layer 3 from Layer 2 in IL 
message buffers. Several variables provide the user with access to the 
information in the packet that is located beyond the packet-type byte. 
These variables are revd_pkt_buff_seg, m_packet_buff_seg, 
rcevd_pkt_sdu_offset, m_packet_sdu_offset, rcvd_pkt_length, and 
m_packet_length. See Section 66.1 for a more detailed discussion of the 
buffer components to which these variables refer. 


3. Pointers. Two variables, rcvd_pkt_info_ptr and m_packet_info_ptr, point to 
the first byte beyond the packet header. You may move these pointers to ( 
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access data throughout the length of the packet. The length is indicated by 
revd_pkt_info_length (or m_packet_info_length). 


4. Path. An IL buffer that is sent down the layers or received up the layers is 
provided with a “path” number that ties it, at X.25 Layer 3, to a particular 
LCN as well as to a particular set of Call Request parameters on the X.25 
Packet Level Setup screen. 


When a call request is sent or received by the INTERVIEW, the call 
parameters are correlated to the Packet Level Setup screen. If the 
INTERVIEW sends.a. call request that. specifies a path number, or if the 
INTERVIEW receives a call request that matches one of the path entries on 
the setup screen, the LCN of the call request is tied to the path number 
(path #3, for example), and any subsequent packets with the same LCN will 
satisfy revd_device_path == 3 conditions. 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /3_enhance or 13_suppress. 
The values are listed in Table 75-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
packets in reverse—-video and suppress display of invalid packets: 


CONDITIONS: RCV RNA 
ACTIONS: 
{ 


i3_enhance = 1; 


} 
CONDITIONS: RCV INVALID 
ACTIONS: 


{ 
13_suppress = 1; 


Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS: RCV DATA 
{ 


i3_enhance == } 


} 
ACTIONS: 
{ 


i3_enhance = 0; 


} 
or an ACTIONS block: 


CONDITIONS: RCV DATA 

ACTIONS: 

{ 

if(t3_enhance == 1} 
{3_enhance = 0; 


) 
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75.3 Routines 


Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following may be displayed: “Error 140: Unresolved reference 13_give_data.” 


(A) Receive 
I3_give_data 
Synopsis 


extern vold 13_give_data(); 


Description 

The /3_give_data routine takes an interlayer message buffer associated with a 
received data packet, changes the SDU offset to point to higher-level data, and 
sends an N_DATA IND primitive up to Layer 4 along with a reference to this 
buffer. The softkey equivalent of this routine is the GV_DATA action on the 
Protocol Spreadsheet. 


Example 


Layer 4 wants access to the line in order to receive and send data. Assuming 
X.25 personality packages are loaded at Layers 2 and 3, enter the following 
program: 


LAYER: 2 
STATE: datalink 
CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO *@(DL_DATA))" 
CONDITIONS: RCV INFO 
ACTIONS: GIVE_DATA 
LAYER: 3 
STATE: pass_data_up 
CONDITIONS: N_CONNECT REQ 
ACTIONS: SEND CALL 
CONDITIONS: RCV CALL_CONF 
ACTIONS: N_CONNECT IND 
CONDITIONS: N_DATA REQ 
ACTIONS: SEND DATA “@(N_DATA))” 
CONDITIONS: RCV DATA 
ACTIONS: 
{ 
i3_give_data(); 
} 
LAYER: 4 
STATE: estabiish_link 
CONDITIONS: ENTER_STATE 
ACTIONS: N_CONNECT REQ 
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(B) Transmit 


I3_clear_path 
Synopsis 


extern void 13_clear_path(path_number); 
unsigned char path_number; 


ription 


The /3_clear_path routine resets P(R)- and P(S)-related variables, clears the 
transmit window, and resets the LCN and address fields to void (unless 
permanently assigned on the Layer 3 X.25 Packet Level Setup screen) on a 
designated path. 


Inputs 


The only parameter is the path number which is to be cleared. The value may 
be 0 - 8, or Oxfe if you want the path number to be that of the ‘last received 
packet. 


Example 


When a Clear packet is received, clear the path. 


LAYER: 3 
STATE: clearing 
CONDITIONS: RCV CLEAR 
ACTIONS: SEND CLEAR_CONF 


{ 
!3_clear_path(Oxfe); 
) 


I3_more_to_resend 


Synopsis 


extern unsigned char {3_more_to_resend(path_number); 
unsigned char path_number; 


Description 

The /3_more_to_resend routine determines whether or not there are any more 
packets in the transmit window to resend. It is used in combination with a 
transitional condition such as packet_sent as a condition on the Protocol 
Spreadsheet. The softkey equivalent is PACKET_SENT MORE_TO_RESEND or 
PACKET_SENT NO_MORE_TO_RESEND. 
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Inputs 


The only parameter is the path number associated with the transmit window. 
The value may be 0 ~ 8, or Oxfe if you want the path number to be that of the 
last received packet. 


Returns 


If there is more to resend, the returned value is non-zero. If there is no more 
to resend, or if the given path is invalid, the returned value is 0. 


Example 


In this example, the entire transmit window will be resent. 


{ 


extern event packet_sent; 


} 
LAYER: 3 
STATE: xfer 
/* Whatever conditions and actions send data precede the following condition. */ 


CONDITIONS: RCV REJ 

ACTIONS: RESEND_FIAST 

NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 


{ 
packet_sent &&(13_more_to_resend(Oxfe) [= 0) 


} 

ACTIONS: RESEND_NEXT 
CONDITIONS: 

{ 


packet_sent &&(13_more_to_resend (Oxfe) == 0} 


} 
NEXT_STATE: xfer 


I3_window_full 
Synopsis 


extern unsigned char {3_window_full(path_number); 
unsigned char path_number; 


Description 

This routine determines whether the Layer 3 window for a specified path is full 
or not full. When the window is full, no additional packets will be buffered until 
some acknowledgment is received. It is used in combination with a transitional 
condition such as receive_packet as a condition on the Protocol Spreadsheet. 
The softkey equivalent is RCV RR (PROTOCL) WINDOW NOT_FULL or RCV RR 
(PROTOCL) WINDOW FULL. 
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Inputs 


The only parameter is the path number whose window is to be checked. The 
value may be 0 - 8, or Oxfe if you want the path number to be that of the last 
received packet. 


Returns 


If the window is full, or if the given path is invalid, the returned value is 
non-zero. If the window is not full, the returned value is 0. 


Example 
Transmit data packets until the transmit window is full. 


{ 


extern event packet_sent; 


} 
LAYER: 3 
STATE: check_window 
CONDITIONS: 


{ 

packet_sent && (13_window_full (Oxfe) [= 0) 
} 

ACTIONS: SEND DATA ‘“(FOX))” 


i3_window_empty 


Synopsis 


extern unsigned char 1{3_window_empty(path_number); 
unsigned char path_number; 


ripti 


This routine determines whether the Layer 3 window for a specified path is 
empty or not empty. It is used in combination with a transitional condition such 
as receive_packet as a condition on the Protoco! Spreadsheet. The softkey 
equivalent is RCV RR (PROTOCL) WINDOW NOT_EMPTY or RCV RA {(PROTOCL) 
WINDOW EMPTY. 


Inputs 


The only parameter is the path number whose window is to be checked. The 
value may be 0 - 8, or Oxfe if you want the path number to be that of the last 
received packet. 


Returns 


If the window is empty, or if the given path is invalid, the returned value is 
non-zero. If the window is not empty, the returned value is 0. 
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Example 


If a timeout expires and the transmit window is not empty, resend the first 
packet in the window. 


{ 
extern event timeout_ack_expired; 
extern event revd_packet; 


) 
LAYER: 3 
STATE: check_window 
CONDITIONS: PACKET_SENT 
ACTIONS: TIMEOUT ack RESTART 
CONDITIONS: 


{ 
revd_packet 


} 
ACTIONS: TIMEOUT ack STOP 
CONDITIONS: 


{ 
timeout_ack_expired && (13_window_empty(Oxfe) [= 0) 


} 
ACTIONS: RESEND FIRST 


resend_packet 
Synopsis 


extern vold resend_packet(path_number, first_or_next)}; 
unsigned char path_number; 
unsigned char first_or_next; 


Description 

The resend_packet routine will resend either the first or next packet in the 
window along a specified path. The softkey equivalent of this routine is the 
RESEND action on the Protocol Spreadsheet. 


Inputs 


The first parameter is the value of the path on which to resend the packet. It 
may be 0 - 8, or Oxfe for the path of the last received packet. 


The second parameter indicates whether the first packet in the window will be 
sent, or whether the next packet in the window will be sent. The first resend 
action will send the first packet in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 


Example 


Suppose you want to resend the entire transmit window if you receive a REJ 
packet. In this example, it’s being sent along the path of the last received 


packet. 
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LAYER: 3 
STATE: xfer 
/* Whatever conditlons and actions send data precede the following condition. */ 


CONDITIONS: RCV REJ 

NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 

ACTIONS: 


{ 
resend_packet(Oxfe, 0); 


) 

CONDITIONS: PACKET SENT 
MORE_TO_RESEND 

ACTIONS: 


{ 

resend_packet (Oxfe,/); 

} 

CONDITIONS: PACKET_SENT 
NO_MORE_TO_RESEND 

NEXT_STATE: xfer 


reset_pr_ps 


Synopsis 


extern void reset_pr_ps{path_number); 
unsigned char path_number; 


Description 
The P(R) and P(S) fields in data and supervisory packets are reset to zero. The 


transmit window is also cleared. The softkey equivalent of this routine is the 
(PROTOCL) RSTPRPS action on the Protocol Spreadsheet. 


Inputs 


The only parameter is the path number on which P(R) and P(S) are to be reset. 
The value may be 0 - 8, or Oxfe if you want the path number to be that of the 


last received packet. 


Example 


In this example, P(R) and P(S) are reset on path 2 whenever a Reset packet is 
received. ; 


LAYER: 3 
STATE: reset 
CONDITIONS: RCV RESET 
ACTIONS: 
{ 
reset_pr_ps(2); 
} 
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send_packet 
Synopsis 


extern void send_packet{il_buffer_number, relay_baton, data_start_offset, 
transmit_packet_ptr); 

unsigned short il_buffer_number; 

unsigned short relay_baton; 

unsigned short data_start_offset; 


Struct send_packet_structure 
{ 
unsigned char path_num; 
unsigned char packet_type; 
unsigned char packet_type_byte; 
unsigned char m_bit; 
unsigned char d_bit; 
unsigned char q_bit; 
unsigned char pr_type; 
unsigned char ps_type; 
unsigned char pr_value; 
unsigned char ps_vatue; 
unsigned char cause; 
unsigned char diag flag 
unsigned char diag; 
unsigned char entri_byte; 
unsigned char facilities_len; 
char * facilities; 

unsigned short data_ten; 
char * data; 

ih 


Struct send_packet_structure * transmit_packet_ptr; 

Description 

The send_packet routine adds a packet-level header to an interlayer message 
buffer and passes the buffer to Layer 2. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 


Inputs 


The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 


The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See See Section 66.3(A). 


The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See See Section 66.3(A). 


The fourth parameter is a pointer to the packet structure to be sent. For a 
description of send_packet_structure see Table 75-1. 
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Example 


To successfully send a packet out to the line, you must include the Layer 2 
section of the program below. In this example, you are sending a Call Request 
packet with a facilities field present. 


{ 

static unsigned short il_buffer_number; 
static unsigned short relay_baton; 
static unsigned short data_stari_offset; 


struct send_packet_structure 

{ 

unsigned char path_num; 
unsigned char packet_type; 
unsigned char packet_type_byte; 
unsigned char m_bit; 
unsigned char d_bit; 
unsigned char q_bit; 
unsigned char pr_type; 
unsigned char ps_type; 
unsigned char pr_value; 
unsigned char ps_value; 
unsigned char cause; 
unsigned char diag flag 
unsigned char diag; 
unsigned char cntri_byte; 
unsigned char facilities_len; 
char * facilities; 

unsigned short data_ien; 
char * data; 

)s 

static char transmit_string [] = “(FOX)”; 


statle char facilities_string {} = (01°44 45° 45% % ”; 


struct send_packet_structure transmit_packet = {0, Ox!3, 0x13, 0, 0, 0, 0, 0, O, O, 1, 1, 0, 0, 
(sizeof(facilities_string)-1), &facilities_string{0], 0, 0}; 


} 
LAYER: 2 
STATE: datalink 
CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “@€DL_DATA)” 
CONDITIONS: RCV INFO 
ACTIONS: GIVE_DATA 
LAYER: 3 
STATE: send_a_packet 
CONDITIONS: KEYBOARD * ” 
ACTIONS: 
{ 
_get_il_msg_buff(&il_buffer_number, &reiay baton); 
_start_il_buff _list(il_buffer_number, &data_start_offset); 
_insert_il_buff_list_ent(il_buffer_number, data_start_offset, &transmit_string{0}, 
(sizeof(transmit_string) - 1)); 
send_packet(il_buffer_number, relay_baton, data_start_offset, a&transmit_packet); 


} 
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NOTE: A null is appended to the end of an array initialized as a 
string inside quotation marks; it is not appended to the end of an 
array entered inside curly braces. So, if facilities_string was 
initialized as a list of values, like this— 


Static char facilities_string {] = (1, 1, 4, 1, 0x41, Ox45, 0x03, 0x43, 7, 7}; 


—then transmit_packet would look like this— 


struct send_packet_structure transmit_packet = {0, 0x13, 0x13, 0, 0, 0, 0, 0, O, O, I, 
1, 0, O, sizeof(facllities_string), &facilities_string{0}, 0, 0); 
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76 SDLC Library 


When the SDLC package is loaded in via the Layer Setup screen, the following external 
routines and variables become available for use by the programmer. Their use on the 
Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 


The variables and routines approximate SDLC Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 38 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. : 


76.1 Structures 


The structure send_frame_structure defines the format of transmitted SDLC frames. 
See Table 76-1. Use this structure to send frames via the send_frame routine in 
emulate mode. See Section 76.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 


76.2 Variables 


(A) Monitoring Events 


1. Emulate or monitor mode. SDLC events include frames detected, good or 
bad BCC’s, and aborts. All event variables in Table 76-2 containing a dte_ 
or dce_ prefix are valid in either emulate or monitor mode. These event 
variables are dte_frame, dce_frame, dte_good_bec, dce_good_bcc, 
dte_bad_bec, dce_bad_bcc, dte_abort, dce_abort. The variable 
dce_good_bec, for example, equates to DCE GDBCC. 


You can use both dte and dce variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 


CONDITIONS: 
{ 
dte_bad_bcc || dce_bad_bee 


} 
ACTIONS: COUNTER bad_bec INC 
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Table 76-1 
SDLC Structures 


Type Variable Value (hex/decimal) Meaning 
Structure Name: send_frame_structure ‘Structure of a frame In SDLC. Declared as type 


struct. Declared automatically If a 
softkey-entered SEND action is taken. Program 
frames assigned to structure as follows: struct 
send frame_structure name. Reference a 
structure varlable as follows: name.bcc_type. If 
values In the frame structure are not initialized by 
the user, they default to 0. You may initialize the 
values when the structure Is declared: 

struct send_frame_structure name = {2, 1, 1, 0, 


1, 1, 3, 0x71, 3, O}; 


unsigned char addr_type 2 address Is specifled in addr_value varlable below 
3 : loopback 
unsigned char frame_type (The codes for frame_type are the same as for the SOLC-varlabie 
revd_frame_type.) 
unsigned char nr_type 0 auto 
1 value 
2 received ns pilus 1 
3 fast nr sent 
unsigned char ns_type 0 auto 
1 skip 
2 last nr received 
3 value 
unsigned char p_f_type 0 0 
1 1 
2 loopback 
unsigned char bee _type 0 default (bad bec} 
1 good bec 
2 bad bcc 
3 abort 
unsigned char addr_value 00-ff/0-255 
unsigned char entri_byte (actual value of the control byte) 
unsigned char nr_value 0-7 (MOD 8) if nr_type = 1 
unsigned char ns_value 0-7 {MOD 8) if ns_type = 3 
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Table 76-2 
SDLC Variables 


Type Variable Value (hex/decimal) Meaning 


extern event 


a 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 
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dte_frame 


dce_frame 


dte_good_bec 


dce_good_bec 


dte_bad_ bec 


dce_bad_bec 


dte_abort 


dce_abort 


revd_frame 


Invalld_frame 


12_T1 


beo_error 


nr_error 


ns_error 


True when a DTE frame Is 
detected, Line Setup 
configured for emulate or 
monitor mode. 


True when a OCE frame Is 
detected, Line Setup 
configured for emulate or 
monitor mode. 


True when a good BCC |s 
calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a good BCC Is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a bad BCC Is 
calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when a bad BCC Is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when an abort Is detected 
for a OTE frame. Line Setup 
configured for emulate or 
monitor mode. 


True when an abort Is detected 
for a DCE frame. LIne Setup 
configured for emulate or 
monitor mode. 


True when a frame Is recelved. 
Line Setup configured for 
emulate mode only. 


True when an invaltd frame Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when the T1 tlmeout-timer 
has expired. Line Setup 
conflgured for emulate mode 
only. 

True when a BCC error Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when an N(R) error Is 
detected in a received INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

True when an N(S) error Is 
detected In a recelved INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 76-2 (continued) 


Type 


Variable 


Value (hex/decimal) 


Meaning 


extern event 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


frame_sent 


m_frame_addr 
m_frame_type- 
m_frame_cntrl_byte_1 


m_frame_pf 


m_frame_bec_type 


revd_frame_addr 


revd_frame_type 


revd_frame_cntr!_byte_1 


revd_frame_pf 


00-ff/0-255 


True when frame is passed 

down to Layer 1. Line Setup 
configured for emulate mode, 
only. ; 


Line Setup configured for 
emulate or monitor mode. 


. (same as revd_frame_type—Line Setup 


contigured for emulate or monitor mode} 


(actual value of control byte—Line Setup 
configured for emulate or monitor mode) 


0 
10/16 


00-f1/0-255 


NNOQAON-O 
_ 
ow 


f/45 
23/35 
43/67 
43/67 
63/99 
83/131 
87/135 
af/175 
c7/199 
of/207 
e3/227 
ef/239 
b/11 
{f/240 
ff/240 


pf=0 
pf=1 
Line Setup conflgured for 
emulate or monitor mode. 


good 
bad 
abort 


Line Setup configured for 
emulate or monitor mode. 


Line Setup configured for 
emulate mode only. 


info 
rr 

roc 
rej 
sre] 
ul 

rim 
sim 
dm 
up 
dise 
rd 

ua 
snrm 
frmr 
xld 
efor 
snrme 
test 
ben 
Ipda 
other 
unknown 


Line Setup conflgured for 
emulate mode only. 


(actual value of contro! byte—Line Setup 
contigured for emulate mode only) 


0 
10/16 


pf=0 
pf=1 


Line Setup configured for 
emulate mode only. 
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Table 76-2 (continued) 


Type Variable Value (hex/decimal) Meaning 
extern volatile const unsigned char revd_frame_bco_type 1 good 
2 bad 
3 abort 


extern volatile const unsigned char 


extern volatiie const unsigned char 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 
extern volatiis unsigned short 


extern volatile unsigned short 


JUL ‘90 


revd_frame_nr 0-7 {MOD 8) 
revd_frame_ns 0-7 (MOD 8) 


revd_frame_buff_seg 


revd_frame_sdu_offset 


revd_frame_sdu_slize 


I2_current_window_edge 


|2_lower_window_edge 
12_upper_window_edge 


I2_resend_edge 


Line Setup configured for 
emulate mode only. 


Line Setup configured for 
emulate mode only. 


Line Setup configured for 
emulate mode only. 


Inter-layer message buffer 
number (actually, an [APX-286 
segment number) in a received 
frame, This segment number 
can be converted to a polnter 
by shifting it left 16 bits. Line 
Setup conflgured for emulate 
mode only. 


Offset to where the service data 
unit begins in an Inter-iayer 
message buffer In a recelved 
frame. Add to buffer segment 
number (con-erted to polnter} 
to point to first byte In frame, 
LIne Setup configured for 
emulate mode only. 


Slze of service data unlit ina 
recelved frame. Line Setup 
configured for emulate mode 
only. 


When equal to upper edge, 
window Is full; when equal to 
lower edge, window Is empty; 
when not equal to upper edge, 
window Is not full; and when not 
equal to lower edge, window Is 
not empty. Line Setup 
configured for emulate mode 
only. Valld for point-to-point 
operation only. 


see I2_current_window_edge 
see I2_current_window_edge 


When resend edge is not equal 
to lower window edge, there Is 
more to resend; when resend 
edge Is equal to lower window 
edge, there Is no more to 
resend. Line Setup configured 
for emulate mode only. 


76-5 


INTERVIEW 7000 Series Advanced Programming: ATLC-107-951-108 


Table 76-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern unsigned char 


extern unsigned char 


I2_enhance 0 normal 

1 reverse 

4 low 

5 reverse low 

8 blink 

9 reverse blink 

12/18 blink low 
Line Setup configured for 
emulate or monitor mode. 


{2_suppress 0 off 
1 on 


Line Setup configured for 
emulate or monitor mode. 


Using spreadsheet tokens, the same test needs two CONDITIONS/ACTIONS 
blocks: 


CONDITIONS: DTE BDBCC 
ACTIONS: COUNTER bad_bee INC 
CONDITIONS: OCE BDBCC 
ACTIONS: COUNTER bad_bec INC 


When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 


{ 
dte_frame && (m_frame_type == @) 


} 


As a C programmer, you do not have to specify a frame type. To include 
all frames in a condition, use the event variable only: 


CONDITIONS: 


a4 


dte_frame 
} 


Emulate mode only. Some events may be detected in emulate mode only. 
The event variables are rcvd_frame, invalid_frame, 12_T1, bcc_error, 
nr_error, ns_error, and frame_sent. 


If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference revd_frame.” 


When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
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frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 


{ 
revd_frame && (revd_frame_type == 0) 
) 


In a C condition, a frame type does not have to be specified. To include all 
received frames in a condition, use the event variable only: 


CONDITIONS:. 


revd_frame 


) 


Error detecting may be accomplished via bec_error, nr_error, ns_error, and 
invalid_frame. These variables equate to the softkey tokens bearing similar 
names. 


One of the emulate—mode variables monitors an emulate action. The event 
variable frame_sent will come true as soon as the frame has been passed to 
the layer below. 


(B) Status Variables 


Status variables are those in Table 76-2 that do not include evens in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for received Info frames is RCV INFO, The C 
version of the same condition should look like this: 


CONDITIONS: 


{ 
revd_frame && (revd_frame_type == 0) 


} 


1. Frame characteristics. All status variables in Table 76-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m_frame_addr, 
m_frame_type, m_frame_cntri_byte_1, m_frame_pf, and m_frame_bcc_type. 
Use these variables to monitor a particular address, frame type, control byte, 
P/F value, or BCC. 


All status variables in Table 76-2 containing a rcvd_ prefix are valid in 
emulate mode only: rcvd_frame_addr, rcvd_frame_type, 
revd_frame_cntri_byte_1, rcvd_frame_bec_type, revd_frame_pf, 
rcvd_frame_nr, and rcvd_frame_ns. Use these variables to monitor a 
particular address, frame type, control byte, BCC, or P/F, N(R}, or N(S) 
value. 
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If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_frame_type.” 


2. Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd_frame_buff_seg, 
revd_frame._sdu_offset, and rcvd_frame_sdu_size. See Section 66.1 for a 
more detailed discussion of the buffer components to which these variables 
refer. 


Make a pointer to an IL buffer by casting rcvd_frame_buff_seg as a long, 
shifting it left sixteen bits, adding rcvd_frame_sdu_offset, and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset). 


{ 


unsigned char * ptr; 
ptr = (void *)(((long)revd_frame_buff_seg << 16) + revd_frame_sdu_offset); 
pirt=2; 


} 


It is now pointing at the first byte in the information field. You may 
continue to move through the frame for its entire length, indicated in 
revd_frame_sdu_size. 


3. Transmit window, Four related variables test the status of the Layer 2 
window in point-to-point operation. The particular values of these variables 
at any given time is not significant. What is significant is how they compare 
to each other. The softkey status condition on the left makes the variable 
comparison on the right: 


WINDOW FULL i2_current_window_edge == [2_upper_window_edge 
WINDOW EMPTY {2_current_window_edge == i2_lower_window_edge 
WINDOW NOT_FULL i2_current_window_edge |= 12_upper_window_edge 
WINDOW NOT_EMPTY 12_current_window_edge {= |2_lower_window_edge 
MORE_TO_RESEND i2_resend_edge != 12_lower_window_edge 


NO_MORE_TO_RESEND I2_resend_edge == 12_lower_window_edge 
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(C) Controlling Protocol Trace Display 


To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /2_enhance or /2_suppress. 


The values are listed in Table 76-2. To assign a value to either of these 


variables, place the statement in an ACTIONS block. For example, display RNR 


frames in reverse-video and suppress display of invalid frames: 


CONDITIONS: RCV RNA 
ACTIONS: 
{ 


{2_enhance = 1; 


}- 

CONDITIONS: RCV INVALID 
ACTIONS; 

{ 


!2_suppress = 1; 


} 
Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS; RCV INFO 
{ 


i2_enhance == 


} 
ACTIONS: 
{ 


12_enhance = 0; 


) 


or an ACTIONS block: 


CONDITIONS: RCV INFO 
ACTIONS: 


if(12_enhance == 1) 
12_enhance = 0; 


) 


76.3 Routines 
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Use the following routines in emulate mode only. If you try to call one of these 


routines in monitor mode, you will be returned to the main program menu. When 


you go to the Protocol Spreadsheet and search for errors, a message like the 
following will be displayed: “Error 140: Unresolved reference 12_give_data.” 
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(A) Receive 
I2_give_data 
Synopsis 


extern void 12_give_data(); 

Descripti 

The /2_give_data routine takes takes an interlayer message buffer associated with 
a received INFO frame, changes the SDU offset to point to higher-level data, 
and sends a DL_DATA IND primitive up to Layer 3 along with a reference to 


this buffer. The softkey equivalent of this routine is the GIVE_DATA action on the 
Protoco! Spreadsheet. 


Example 


Layer 3 wants access to the line in order to receive and send data. Assuming 
the SDLC personality package is loaded at Layer 2, enter the following program: 


LAYER: 2 
STATE: datallnk 

CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “(DL_DATA))” 
CONDITIONS: RCV INFO 
ACTIONS: 


{ 
12_give_data(); 


(B) Transmit 
resend_frame 


nopsi 


extern void resend_frame(pf, first_or_next); 
unsigned char pf; 
unsigned char first_or_next; 


Description 


The resend_frame routine will resend either the first or next frame in the 
window with the P/F bit set to a specified value. 


NOTE: To ensure that thi executes properly, select 
Emulation Addressing: {BOINTSTG=FGINT: on the SDLC Frame Level 


Setup screen. For either point-to-point or multi-drop operation, 
see resend_frame_multi. 
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Inputs 


The first parameter is the value of the P/F bit in the frame. It may be set to 
either zero or one. 


The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 


Example 


Suppose you want to resend the entire transmit window if you receive a REJ 
frame, 


LAYER: 2 
STATE: xfer 
/* Whatever conditions and actlons send data precede the following condition. */ 


CONDITIONS: RCV REJ RESP 

NEXT_STATE: recover ~ 
STATE: recover 

CONDITIONS: ENTER_STATE 

ACTIONS: 

{ 

resend_frame(I, 0); 


} 
CONDITIONS: FRAME_SENT 


MORE_TO_RESEND 
ACTIONS: 


{ 
resend frame(1,1); 


} 

CONDITIONS: FRAME_SENT 
NO_MORE_TO_RESEND 

NEXT_STATE: xfer 


resend_frame_multi 
Synopsis 


extern void resend_frame_multi(pf, first_or_next, addr_value); 
unsigned char pf; 

unsigned char first_or_next; 

unsigned char addr_value; 


Description 
The resend_frame_muilti routine will resend either the first or next frame in the 
window to a specified controller address. The softkey equivalent of this routine 
is the (PROTOCL) RESEND action on the Protocol Spreadsheet. 

NOTE: For multi-drop operation, select Emujatlon Addressing: 
on the SDLC Frame Level Setup screen. 
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Inputs 


The first parameter is the value of the P/F bit in the frame. It may be set to 
either zero or one. 


The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 


The third parameter is the value of the controller address. The specified address 
must be listed: in the ADDR table on the SDLC Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable rcyd_frame_addr. 


Example 


Suppose you want to resend the entire transmit window for the controller address 
in a received REJ frame. 


{ 


extern volatile const unsigned char revd_frame_addr; 


) 
LAYER: 2 
STATE: xfer 
/* Whatever conditions and actlons send data precede the following conditlon. */ 


CONDITIONS: RCV REJ RESP 
NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 

ACTIONS: 

{ 

resend_frame_multi(!, 0, revd_frame_addr}; 

) 

CONDITIONS: FRAME_SENT 
MORE_TO_RESEND 

ACTIONS: 

{ 

resend_frame(!,1, revd_frame_addr ); 

} 

CONDITIONS: FRAME_SENT 
NO_MORE_TO_RESEND 

NEXT_STATE: xfer 


reset_nr 
Synopsis 


extern void reset_nr(); 


Description 


This routine resets the N(R) field in information and supervisory frames to zero. 
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NOTE: To ensure that this routine executes properly, select 
Emulation Addressing: = on the SDLC Frame Level 
Setup screen. For either point-to-point or multi-drop operation, 
see reset_nr_multi. 


Example 


When a link is established, reset N(R). 


LAYER: 2 
STATE: reset 
CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS; RCV UA 
ACTIONS: 


{ 


reset_nr(); 


reset_nr multi 


Synopsis 


extern void reset_nr_multi(addr_vatue); 
unsigned char addr_vatue; 


_ Description 


This routine resets to zero the N(R) field in information and supervisory frames 
for a specified controller address. The softkey equivalent of this routine is the 
(PROTOCL) RSET_NR action on the Protocol Spreadsheet. 


NOTE: For multi-drop operation, select Emulatlon Addressing: 
on the SDLC Frame Level Setup screen. 


Inputs 


The only parameter is the value of the controller address. The specified address 
must be listed in the ADDR table on the SDLC Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable revd_frame_addr. 
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Example 


When a link is established, reset N(R) for address in received UA frame. 


{ 


extern volatile const unsigned char revd_frame_addr; 


} 
LAYER: 2 
STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SAB8M 
CONDITIONS: -ACV.UA. 
ACTIONS: 
{ 


reset_nr_muitl(revd_frame_addr)}; 


} 


reset_ns 


Synopsis 


extern void reset_ns(); 
Description 


The N(S) field in information frames is reset to zero and the transmit window is 
cleared. 


NOTE: To ensure that this routine executes properly, select 
Emulation Addressing: 
Setup screen. For either point-to-point or multi-drop operation, 
see reset_ns_multi. 


Example 


When a link is established, reset N(S). 


LAYER: 2 
STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 
{ 
reset_ns(); 


} 
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reset_ns multi 
Synopsis 


extern void reset_ns_multi{addr_vatue); 
unsigned char addr_vatue; 


Description 
This routine resets to zero the N(S) field in information frames for a specified 


controller address. It also clears the transmit window. The softkey equivalent of 
this routine is the {PROTOCL) RSET_NS action on the Protocol Spreadsheet. 


NOTE: For multi-drop operation, select Emulation Addressing: 
MU on the SDLC Frame Level Setup screen. 


Inputs 


The only parameter is the value of the controller address. The specified address 
must be listed in the ADDR table on the SDLC. Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable revd_frame_addr. 


Example 
When a link is established, reset N(S)} for address in received UA frame. 
{ 
extern volatile const unsigned char rcvd_frame_addr; 
' oe 2 


STATE: reset 
CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 
{ 
reset_ns_multi(rcvd_frame_addr); 


} 


send_frame 
Synopsis 


extern void send_frame(il_buffer_number, retay_baton, data_start_offset, transmit_frame_ptr); 
unsigned short il_buffer_number; 

unsigned short relay_baton; 

unsigned short data_start_offset; 

struct send_frame_structure 

{ 

unsigned char addr_type; 

unsigned char frame_type; 

unsigned char nr_type; 
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unsigned char ns_type; 
unsigned char p_f type; 
unsigned char bee_type; 
unsigned char addr_vatue; 
unsigned char cntrl_byte; 
unsigned char nr_value; 
unsigned char ns_value; 
}s 


struct send_frame_Structure * transmit_frame_ptr; 


Description 


The send_frame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 


Inputs 


The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 


The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66.3(A). 


The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). 


The fourth parameter is a pointer to the frame structure to be sent. For a 
description of send_frame_structure see Table 76-1. 


Example 


Send an Info frame containing a canned fox message and a good BCC onto the 
line. 


{ 


static unsigned short il_buffer_number; 
static unsigned short relay_baton; 
static unsigned short data_start_offset; 
struct send_frame_structure 
{ 
unsigned char addr_type; 
unsigned char frame_type; 
unsigned char nr_type; 
unsigned char ns_type; 
unsigned char p_f_type; 
unsigned char bec_type; 
unsigned char addr_value; 
unsigned char entrl_byte; 
unsigned char nr_value; 
unsigned char ns_value; 
}s 
Struct send_frame_structure transmit_frame; 
static char transmit_string {] = “Q(FOX))”; 


) 
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LAYER: 2 
STATE: send_a_frame 
CONDITIONS: KEYBOARD * ” 
ACTIONS: 
{ 
_get_il_msg_buff(&il_buffer_number, &relay_baton}; 
_Start_il_buff_list(il_buffer_number, &data_start_offset); 
transmit_frame. bcc_type = 1; 
_insert_il_buff_list_ent(il_buffer_number, data_start_offset, &transmit_string{0], 
(sizeof(transmit_string) - 1)); 
send_frame(il_buffer_number, reiay_baton, data_start_offset, &transmit_frame); 
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77 SNA Library 


When the SNA package is loaded in via the Layer Setup screen, the following externa! 
variables become available for use by the programmer. Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 2. 


SDLC variables and routines, while they are included in the SNA layer—personality package, 
are not documented here. They are documented fully in Section 76. 


Those variables that are specific to the SNA package are documented here. They pertain to 
fields in SNA transmission headers, request/response headers, and request/response units. 
These variables have no spreadsheet-token equivalents. 


77.1. Structures 


Use the SDLC send_frame_structure shown in Table 76-1. 


77.2 Variables 


The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate—only 
conditions and actions on the Protocol Spreadsheet. 


(A) Monitoring Events 
Use the SDLC event variables discussed in Section 76.2(A). 


(B) Status Variables 


All SNA variables in Table 77-1 are status variables. Also refer to the SDLC 
status variables listed in Table 76-2. 


There are no softkey tokens on the spreadsheet that are equivalent to the SNA 
variables listed in Table 77-1. To search for Info frames with a FID2 
transmission header, for example, use C variables. The condition should look 
like this: 


CONDITIONS: 

{ 

dte_frame && (m_frame_type == 0) && (m_packet_fid_type == 2) 
) 
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Table 77-1 
SNA Varlablest 


Type 


Variable 


Value (hex/decimal) Meaning 


extern volatile unsigned short 


extern volatile const unsigned char 


extern volatile const unsigned short 


extern volatile const unsigned short 


extern volatile const unsigned long 


extern volatile const unsigned char 


extern volatile const unsigned short 


extern volatiie const unsigned short 


extern volatile const unsigned long 


m_packet_length 


n 
m_packet_ftd_type 


m_packet_daf 
m_packet_def 
m_packet_dsaf 


m_packet_Isid 


m_packet_oaf 
m_packet_oef 


m_packet_osaf 


er: 


hwn-sO 


— 


415 


O-fff10-65535 


0-ffff/0-65535 


O-1ff FEET 
0-4294967295 


(actual value 
of byte) 


00-ff10-255 


00-1110-255 


O-ffFFEETET 
0-4294967295 


Length of the packet, Including 
the transmission and 
request/response headers. Line 
Setup configured for emulate or 
monitor mode. 


rmat | Ification Type: 
FIDO; TH 10 bytes 
FID1; TH 10 bytes 
FID2; TH 6 bytes 
FID3: TH 2 bytes 
FID4: TH 26 bytes 
FIDF; TH 26 bytes 


LIne Setup configured for 
emulate or monitor mode. 


Destination address fleld—2 
bytes in FiDO and FID1; 1 byte 
in FID2, Line Setup configured 
for emulate or monitor mode, 


Destination element fleld—2 
bytes; FID4 only, Line Setup 
configured for emulate or 


monitor mode. 


Destlnatlon subarea address 
field—4 bytes; FID4 only. 
Line Setup configured for 
emulate or monitor mode. 


Local Sesslon Identification: 
FID3 only 

SSCP-PU session 
SSCP-LU session 

Reserved 

LU-LU session 


Line Setup configured for 
emulate or monitor mode. 


Orlgin address fleld—2 bytes In 
FIDO and FID1; 1 byte In FID2. 
Line Setup configured for 
emulate or monitor mode. 


Origin element fleld—2 bytes; 
FID4 only. Line Setup 
configured for emulate or 
monitor mode. 


Orlgin subarea address fleld—4 
bytes; FID4 only. Line Setup 
configured for emulate or 


monitor mode. 


a 
+ Refer to Table 76-2 for SDLC varlables. 
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Table 77-1 (continued) 


Type 


Value (hex/decimal) 


Meaning . 


extern volatite unsigned char * 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile unsigned char 


extern volatile unsigned char 


extern volatile unsigned char * 


extern volatile unsigned char * 


Variable 
Transmission Header (continued); 
th_ptr 

uest/ onse Header: 
m_packet_ru_category 

0 

20/32 

40/64 

60/96 
m_packet_fl 

0 

8 
m_packet_rri 

0 

80/128 
m_packet_rtl 

0 

10/16 
m_packet_sdl 

0 

4 


_rh_ptr 


/Response Unit: 
ru_ptr 


Polnter for the transmission 
header; begins at the byte 
containing FID type. Line Setup 
configured for emulate or 
monitor mode. 


Request/Response Unit: 


Functlon Management Data 
(FMD} 

Network Control (NC) 

Data Flow Control (DFC) 
Session Control {SC) 


Line Setup configured for 
emulate or monitor mode. 


Format Indicator: 

User data without header in RU 
In LU-LU frame, indicates 
header follows the RH. In SC, 
NC, or DFC RU, Indicates a 
formatted RU beginning with a 
request code. 


Line Setup conflgured for 
emulate or monitor mode. 


Request/Response Indicator: 


request 
response 


LIne Setup configured for 
emulate or monitor mode. 


Besponse Type Indicator: 


positive response 
negative response 


Line Setup configured for 
emulate or monitor mode. 


Sense Data Indicator: 
sense data not Included 
sense data Included 


Line Setup configured for 
emulate or monitor mode. 


Pointer for the request/response 
header; begins at the byte 
contalning the request/response 
Indicator, Line Setup configured 
for emulate or monitor mode, 


Pointer for the raquest/response 
unlt; begins at the first byte In 
the unit. Line Setup configured 
for emulate or monitor mode. 


Ne ee eee ee ee ————eeeeeet 
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1. Info frame characteristics. Most status variables in Table 77-1 contain an 
m_ prefix, indicating that they are valid in emulate or monitor mode. Some 
variables are associated with the transmission header: m_packet_fid_type, 
m_packet_daf, m_packet_def, m_packet_dsaf, m_packet_lsid, m_packet_oaf, 
m_packet_oef, and m_packet_osaf. Other variables are associated with the 
request/response header: m_packet_ru_category, m_packet_fi, m_packet_rri, 
m_packet_rti, and m_packet_sdi. 


2. Pointers. There are three pointers to SNA fields. th_ptr points to first byte 
of the transmission header, rh_ptr points to the first byte of request/response 
header, and ru_ptr points to the start of the request/response unit. 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular packets on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /2_enhance or /2_suppress. 
The values are listed in Table 76-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
Info frames with FID2 transmission headers. Of these, display frames with sense 
data in reverse-video. 


CONDITIONS: 


die_ frame && (m_frame_type == 0) && (m_packet_fid_type {= 2) 
) 
ACTIONS: 


{ 
i2_suppress = 1; 


) 
CONDITIONS: 


{ 
dte_frame && (m_frame_type == 0) && (m_packet_fid_type == 2) && (m_packet_sdi == 4) 


} 
ACTIONS: 
12_enhance = [; 


} 


Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS: 


{ 
dte_frame && (m_frame_type == 0) && (m_packet_fid_type != 2) && (12_suppress == 0) 


} 
ACTIONS: 
{ 


i2_suppress = 1; 


} 
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or an ACTIONS block: 


CONDITIONS: 


{ 
dte_frame && (m_frame_type == 0) && (m_packet_fid_type != 2) 


y 
ACTIONS; 


{ 
if(l2_suppress == 0) 
12_suppress = 1; 


77.3 Routines 


There are no routines associated exclusively with SNA. Use the SDLC routines 
discussed in Section 76.3. To send a frame including SNA protocol, for example, 
include a transmit_string of SNA data in the send_frame routine. 
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78 DDCMP Library 


When the DDCMP package is loaded ‘in via the Layer Setup’screen, the following external 
variables become available for use by the programmer, Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 1. 


78.1 Structures 


There are no extern structures associated exclusively with DDCMP. 


78.2 Variables 


The only variables exclusive to DDCMP relate to block checking. When the 
DDCMP package is loaded in, the results of both header and data block checks are 
displayed on the data screen. If you want your program to detect good or bad , 
BCC's, you may use the BCC selections on the trigger menus and at Layer 1 of the 
Protocol Spreadsheet to interrogate the header block check only. 


If you want to detect a good or bad data block check, you must use one of the C 
event variables listed in Table 78-1. 


Here is a program that counts bad DTE BCC’s for both header and data: 


extern fast_event fevar_bd_bcec2_td; 
LAYER: 1 
STATE: count_all_bad_dte_becs 
CONDITIONS: DTE BAD_BCC 
ACTIONS: COUNTER t_bdbce INC 
CONDITIONS: 
fevar_bd_bec2_td 


) 
ACTIONS: COUNTER t_bdbce INC 


78.3 Routines 


There are no routines associated exclusively with DDCMP. 
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Table 78-1 
DDCMP Variables 


Type Variable Value (hex/decimal) Meaning 


extern fast_event 


extern fast_event 


extern fast_event 


extern fast_event 


extern fast_event 


extern fast_event 


extern fast_event 


extern fast_event 


fevar_gd_bec_rd 


fevar_gd_bec_td 


fevar_bd_bec_rd 


fevar_bd_bec_td 


fevar_gd_bcc2_td 


fevar_gd_bec2_rd 


fevar_bd_bee2_td 


tevar_bd_bec2_rd 


True when a good header BCC 
is recelved on RD. Line Setup 
configured for emulate or 
monitor mode. 


True when a good header BCC 
Is recelved on TD. Line Setup 
configured for emulate or 
monitor mode. 


True when a bad header BCC Is 
received on RD. Line Setup 
configured for emulate or 
monitor mode. 


True when a bad header BCC Is 
received on TD. Lins Setup 
configured for emulate or 
monitor mode. 


True when a good data BCC Is 
received on TD. Line Setup 
configured for emulate or 
monitor mode. 


True when a good data BCC Is 
received on RD. Line Setup 
configured for emulate or 
monitor mode. 


True when a bad data BCC Is 
recelved on TD. Line Setup 
conflgured for emulate or 
monitor mode. 


True when a bad data BCC Is 
recelved on RD. Line Setup 
configured for emulate or 
monitor mode. 
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To use the C structures, variables, and routines explained in this section, your INTERVIEW 
must be equipped with Option 15. Install the ISDN Test Interface Module (TIM) in the rear 
of the INTERVIEW, as explained in Section 12. Also install the ISDN mux board according 
to the directions in Appendix J4. Load in the ISDN_D Layer 1 package via the Layer Setup 
screen. The ISDN_D package contains the variables and most of the routines documented 
below. Finally, select one of the B channels in the Channel! field on the ISDN Interface 
Setup screen. See Section 51.5. 


The configuration of the INTERVIEW described above supports dual-channel monitoring. 
Dual-channel monitoring means tracking one of the B channels and the D channel. All 
menu selections (with the possible exception of Speaker on the ISDN Interface Setup menu), 
triggers, and spreadsheet conditions and actions apply to the B channel selected. Use the C 
structures, variables, and routines in this section to monitor the D channel. 


NOTE: When the ISDN Interface Setup screen shows Channel: 
your unit is configured for single-channel monitoring. 
Menu selections, triggers, and the Protocol Spreadsheet apply to 
the D channel. Do not load in the ISDN_D Layer 1 package. 


You may develop your own program to monitor the D channel, or simply load and run the 
program contained in the ISDN trace application package (available as OPT-951-35). 


79.1 Structures 


Use the structure xmit_list, shown in Table 79-1, when transmitting on the D channel 
via the send_d_frame routine. Refer to send_d_frame in Section 79.3 for an 
example of how to use this structure. 


Table 79-1 
ISDN Structures 


Type Variable Value (hex/decimal) Meaning 


Structure Name: xmit_list Structure of a transmit list for send_d_frame 
routine. Declared as type struct. Reference 
member variables of the structure as follows: 
xmit_list.string_length. 


unsigned char * string polnter to the location of the transmit string—the 
transmit string Is declared separately 
unsigned short string_length O-ffff10-65538 tength of the transmlt string 
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79.2 Variables 


There are three event variables associated with the ISDN_D personality package. 
They are d_dte_frame, d_dce_frame, and d_rcv_frame. See Table 79-2. 


(A) Monitoring Events 


1. In monitor mode, When a frame is detected on the D channel, one monitor 
event, d_dce_frame or d_dte_frame, is signaled. Use both event variables to 
construct an ISDN trace. 


2. In emulate mode. In emulate mode, the receive event d_rcv_frame and one 
of the monitor events are signaled when a frame is received on the D 
channel. The INTERVIEW’s transmissions on the D channel may not be 
monitored when the unit is in dual-channel mode. The implication of this 
difference is that ISDN trace programs written in monitor mode may not be 
placed intact in an emulation program. 


Table 79-2 
ISDN Variables 


Type Variable Value (hex/decimal) Meaning 


extern event d_dte_frame True when a DTE frame Is 
detected on the D channel. 
Line Setup configured for 
emulate or monitor mode. 


extern event d_dce_frame True when a DCE frame Is 
detected on the D channel. 
tIne Setup conflgured for 
emulate or monitor mode. 


extern event d_rcv_frame True when a frame Is received 
on the D channel. Line Setup 
configured for emulate mode 
only. 


79.3 Routines 


There are two routines associated with the ISDN_D package: send_d_frame and 
send_d_frame_il. Another ISDN routine, set_isdn_speaker_chan, controls the 
speaker for either of the B channels. This routine is supplied by the ISDN Test 
Interface Module. 


(A) Transmit 


Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. 
When you go to the Protocol Spreadsheet and search for errors, a message like 
the following may be displayed: “Zrror 140: Unresolved reference 
send_d_frame_il.” 
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send_d_frame 


nopsi 


extern void send_d_frame(count, struct_send_string_pir, xmit_tag); 
unsigned short count; 
Struct xmit_list 
{ 
unsigned char * string_ptr; 
unsigned short string length; 
}; 
struct xmit_list * struct_send_string_ptr; 
unsigned short xmit_tag; 


Description 


The send_d_frame routine sends a specified string on the D channel with a 
user—determined BCC. 


Inputs 


The first parameter is the number of strings to be sent. 


The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 


The third parameter is a transmit tag which includes a BCC in bits 0-2: good 
(001), bad (010), or abort (011). Bits 3-7 are reserved for future use. 

Integers may be used to indicate the value of the transmit tag: good (1), bad 
(2), and abort (3). 


: 


Example 


Assume you want to send on channel D a fox message inside of an X.25 data 
packet with a good block check. You might have 2 strings, one with the Layers 
2 and 3 header information, and one with the fox message. You would send 
these strings as follows: 


{ 
unsigned char headers [}] = {Ox01, 0x00, Ox10, 0x04, 0x00}; 


unsigned char message {] = “(FOX)”; 
struct xmit_list 
{ 
unsigned char * string; 
unsigned short string length; 
} 
struct xmit_list send_string [] = {&headers{0}, 5, &message{0], sizeof(message) - 1}; 


) 


a 
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LAYER: 1 
STATE: send_message 
CONDITIONS: KEYBOARD “ " 
ACTIONS: 


{ 
send_d frame(2, &send_string{0], 1); 


send_d_frame_il 


Synopsis 


extern void send_d_frame_il(il_buffer_number, relay_baton, data_start_offset, transmit_tag); 
unsigned short it_buffer_number; 

unsigned short relay_baton; 

unsigned short data_start_offset; 

unsigned short transmit_tag; 


Description 


This routine sends a designated interlayer message buffer out on the D channel. 


Inputs 
The first parameter is the interlayer message buffer number. 


The second parameter is the maintain bit used to hold the buffer while the send 
operation is performed at Layer 1. 


The third parameter is the offset from the beginning of the buffer to the service 
data unit (SDU). 


The fourth parameter is a transmit tag which includes a BCC in bits 0-2: good 
(001), bad (010), or abort (011). Bits 3-7 are reserved for future use. 
Integers may be used to indicate the value of the transmit tag: good (1), bad 
(2), and abort (3). 


Example 


Send the same text as in the example for send_d_frame. Refer to Section 
66.3(A) for a description of the _get_il_msg_buff, _start_il_buff_list, and 
_insert_il_buff_list_cnt routines. 


{ 

unsigned short il_buffer_number; 

unsigned short relay_baion; 

unsigned short data_start_offset; 

unsigned char message [] = “%\x000'0°«\x000( FOX)”; 


} 
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LAYER. 14 
STATE: send_message 
CONDITIONS: KEYBOARD “ ” 
ACTIONS: 
{ 
_get_il_mse_buff(&il_buffer_number, &relay_baton); 
_Start_il_buff_list(il_buffer_number, &data_start_offset); 
_insert_il_buff_list_ent(il_buffer_number, data_start_offset, &message{0], 
(sizeof(message) - 1)); 
send_d_frame_il(il_buffer_number, retay_baton, data_start_offset, 1); 


} 


(B) Speaker Control 


set_isdn_speaker_chan 


nopsi 


extern void set_isdn_speaker_chan(selection); 
unsigned short selection; 


Description 


The set_isdn_speaker_chan routine allows the programmer to control the speaker 
located on the ISDN mux board, Option 15. The programmer may enable the 
speaker for one of the B channels. This selection is independent of the channel 
selected for monitor or emulation on the ISDN Interface Setup screen. 


Inputs 


The only parameter is the channel selection. A value of one means turn the 
speaker on for channel B1. Enable the speaker for channel B2 with two. Turn 
the speaker off by setting the value to zero. 


Example 


Suppose you want to know whether data or voice is being transmitted over 
channel Bl. Use the set_isdn_speaker_chan routine to enable the speaker for 
Bi. Even if you are otherwise using the INTERVIEW to monitor B2, you will 
hear the B1 transmissions. 


LAYER: 1 
STATE: enable_b1 
CONDITIONS: KEYBOARD “sS" 
ACTIONS: 
{ 
Set_isdn_speaker_chan(!); 


} 
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When the LAPD package is loaded in via the Layer Setup screen, the following external 
routines and variables become available. for use. by the programmer. Their use on the 
Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 


The variables and routines approximate LAPD Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 42 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 


80.1 Structures 


The structure send_frame_structure defines the format of transmitted LAPD frames. 
See Table 80-1. Use this structure to send frames via the send_frame routine in 
emulate mode. See Section 80.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 


80.2 Variables 


(A) Monitoring Events 


1. Emulate or monitor mode. LAPD events include frames detected, good or 
- bad BCC’s, and aborts. All event variables in Table 80-2 containing a dte_ 
or dce_ prefix are valid in either emulate or monitor mode. These event 
variables are dte_frame, dce_frame, dte_good_bcc, dce_good_bcc, 
dte_bad_bec, dce_bad_bcc, dte_abort, dce_abort. The variable 
dce_good_bcc, for example, equates to OCE GDBCC. 


You can use both dte and dce variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 


CONDITIONS: 
dte_bad_bcc || dce_bad_bee 


} 
ACTIONS; COUNTER bad_bee INC 
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Table 80-1 
LAPD Structures 


Types Variable Value (hex/decimal) Meaning 
Structure Name: send_frame_structure Structure of a frame In LAPD. Declared as type 


struct. Declared automatically If a 
softkey—entered SEND action js taken. Program 
frames assigned to structure as follows: struct 
send_frame_structure name. Reference a 
structure varlable as follows: name.bec_type. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may initlallze the 
values when the structure is declared: 

struct send_frame_structure name = {1, 1, 2, 0, 


0, 0, 1, 1, t, 0, 0, O}: 


unsigned char sapl_type 1 no other value valid—indicates a value Is given 
unsigned char tel_type 1 no other value valld—indicates a value Is glven 
unsigned char cr_type 0 0 
1 1 
2 loopback 
unsigned char frame_type (The codes for trame_type are the same as for the LAPD-variable 
revd_frame_type.) 
unsigned char nr_type 0 auto 
1 value 
2 received ns plus 1 
3 last nr sent 
unsigned char ns_type 0 auto 
1 skip 
2 last nr recelved 
3 value 
unsigned char p_f_type 0 0 
, 1 1 
2 joopback 
unsigned char beo_type 0 default (bad bec) 
1 goed bcc 
2 bad bce 
3 abort 
unsigned char sapl_value 00-3f/0-63 
unsigned char te[_value 00-7f/0-127 
unsigned char entrl_byte (actual value of the control byte) 
unslgned char nr_value 0-7 (MOD &) if nr_type = 1 
unsigned char ns_value 0-7 {MOD 8) If ns_type = 3 


LL ————— 
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Table 80-2 
LAPD Varlables 
Type Variable Value (hex/decimal) Meaning 
extern event dte_frame True when a DTE frame Is 


detected. Line Setup 
configured for emulate or 
monitor mode. 


extern event dce_frame True when a OCE frame Is 
, detected. Line Setup 
configured for emulate or 
monitor mode. 


extern event dte_good_bce True when a good BCC Is 
calculated for a OTE frame. 
Line Setup configured for 
emulate or monitor mode. 


extern event dee_good_bcc True when a good BCC is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


extern event dte_bad_bee True when a bad BCC Is 
calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 


extern event dce_bad bee True when a bad BCC is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


extern event dte_abort True when an abort Is detected 
for a OTE frame. Line Setup 
comflgured for emulate or 
monitor mode. 


extern event dcee_abort True when an abort Is detected 
for a DCE frame. Line Setup 
configured for emulate or 
monitor mode. 


extern event revd_frame True when a frame Is received. 
Line Setup configured for 
emulate mode only. 


extern event Invalid_frame True when an Invalld frame Is 
detected. Line Setup 
configured for emulate mode 
only. 

extern event 2_T1 True when the T1 tlmeout-timer 
has explred. Line Setup 
configured for emulate mode 
only. 


extern event bec_error True when a BCC error ls 
detected. Line Setup 
configured for emulate mode 
only. 

extern event nr_error True when an N(R) error Is 
detected In a recelved INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

extern event ns_error True when an N(S) error Is 
detected in a received INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 80-2 (continued) 


Type 


Variable 


Value (hex/decimal) 


Meaning 


extern event 


extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


frame_sent 


m_frame_addr_sapl 
m_frame_addr_tet 


m_frame_addr_cr 


m_frame_type 
m_frame_cntri_byte_1 


m_frame_pf 


m_frame_bec_type 


m_frame_nr 
m_frame_ns 
revd_frame_addr_sapl 
rcvd_frame_addr_tel 


revd_frame_addr_cr 


revd_frame_type 


00-3f/0-63 
00~-7f10-127 


0 
1 


True when frame Is passed 
down to Layer 1. Line Setup 
configured for emulate mode 
only. 

Line Setup configured for 
emulate or monitor mode. 
tIne Setup configured for 
emulate or moniter mode. 

0 

1 


Line Setup configured for 
emulate or monitor mode. 


(same as revd_frame_type—Line Setup 
contigured for emulate or monitor mode) 


(actual vaiue of control byte—Line Setup 
conligured for emulate or monitor mode) 


0 
10/16 


0-7 (MOD 8) 
0-7 (MOD 8) 
00-3f/0-63 


00-7f/0-127 


onwa—- Oo 


2/37 
6f/111 
43/67 
f/15 
€/15 
63/99 
67/103 
87/135 
67/224 
f/255 
f/255 


pf=0 
pf=1 
Line Setup conflgured for 
emulate or monitor mode. 


good 

bad 

abort 

Line Setup configured for 
emulate or monitor mode. 


Line Setup configured for 
emulate or monitor mode. 
Line Setup configured for 
emulate or monitor mode. 
Line Setup configured for 
emulate mode only. 

Line Setup configured for 
emulate mode only. 

0 

1 

loopback 

Line Setup configured for 
emulate mode only. 


Info 

rr 

ul 

rr 

re} 
sabm 
sabme 


dise 


dm 

sarm 

ua 

slo 

freor 

sit 

other 

unknown 

Line Setup configured for 
emulate mode only. 
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Table 80-2 (continued) 


Type 


Variable 


Value (hex/decimal) 


Meaning 


extern volatiie const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatiic const unsigned char 
extern volatile const unsigned char 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 
extern volatile unsigned short 
extern volatile unsigned short 
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revd_frame_cntrl_byte_1 


revd_frame_pf 


rcvd_frame_bec_type 


rcvd_frame_nr 
revd_frame_ns 


revd_frame_buff_seg 


revd_frame_sdu_offset 


revd_frame_sdu_slize 


I2_current_window_edge 


I2_lower_window_edge 
2_upper_window_edge 
I2_resend_edge 


(actual value of control byte—Line Setup 
configured for emulate mode only} 


0 


' 10/16 


wn 


0-7 (MOD 8) 


0-7 (MOD 8) 


pf=0 

pf=t 

Line Setup configured for 
emulate mode only. 


good 
bad 
abort 


Line Setup configured for 
emulate mode only. 


Line Setup configured for 
emulate mode only. 


Line Setup configured for 
emulate mode only. 


inter-layer message buffer 
number (actually, an I|APX-266 
segment number) in a received 
frame. This segment number 
can be converted to a pointer 
by shifting it left 16 bits. Line 
Setup configured for emulate 
mode only. 


Offset to where the service data 
unit begins In an inter-layer 
message buffer in a received 
frame. Add to buffer segment 
number (converted to pointer) 
to polnt to first byte In frame. 
Line Setup configured for 
emulate mode only. 


Size of service data unit in a 
received frame. Line Setup 
configured for emulate mode 
only. 


When equal to upper edge, 
window Is full; when equal to 
lower edge, window Is empty; 
when not equal to upper edge, 
window Is not full; and when not 
equal to lower edge, window Is 
not empty. Line Setup 
configured for emulate mode 
only. 


see |2_current_window_edge 
see I2_currant_window_edge 


When resend edge ts not equal 
to lower window edge, there Is 
more to resend; when resend 
edge Is equal to lower window 
edge, there Is no more to 
resend. Line Setup configured 
for emulate mode only. 
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Table 80-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern unsigned char 


extern unsigned char 


2_enhance 0 normal 

1 reverse 

4 low 

§ reverse low 

8 blink 

9 reverse blink 

12/18 blink low 
Line Setup configured for 
emulate or monitor mode. 


l2_suppress 0 off 
1 on 


Line Setup configured for 
emulate or monitor mode. 


Using spreadsheet tokens, the same test needs two CONDITIONS/ACTIONS 
blocks: 


CONDITIONS: DTE BDBCC 
ACTIONS: COUNTER bad_bec INC 


‘ CONDITIONS: DCE BDBCC 


ACTIONS: COUNTER bad_bee INC 


When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 


{ 
dte_frame && (m_frame_type == 0) 
} 


In C, the programmer does not need to specify a frame type. To include all 
frames in a condition, use the event variable only: 


CONDITIONS: 


{ 
dte_frame 


) 


Emulate mode only. Some events may be detected in emulate mode only. 
The event variables are revd_frame, invalid_frame, 12_T1, bcc_error, 
nr_error, ns_error, and frame_sent. 


If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140; Unresolved reference rcvd_frame.” 


When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
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frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 


{ 
} 


revd_frame && (revd_frame_type == 0) 


The C programmer does not have to specify a frame type. To include all 
received frames in a condition, use the event variable only: 


CONDITIONS: 
{ 


revd_frame 


} 


Error detecting may be accomplished via bcc_error, nr_error, ns_error, and 
invalid_frame. These variables equate to the softkey tokens bearing similar 
names. 


One of the emulate~mode.variables monitors an emulate action. The event 
variable frame_sent will not come true until the frame actually has been 
passed to the layer below. 


(B) Status Variables 


Status variables are those in Table 80-2 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for received Info frames is RCV INFO. The C 
version of the same condition should look like this: 


CONDITIONS: 


{ 
revd_frame && (revd_frame_type == 0} 


} 


1. Frame characteristics. All status variables in Table 80-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m_frame_addr_sapi, 
m_frame_addr_tei, m_frame_addr_cr, m_frame_type, m_frame_cnirl_byte_l, 
m_frame_pf, m_frame_bcc_type, m_frame_nr, and m_frame_ns. 


All status variables in Table 80-2 containing a revd_ prefix are valid in 
emulate mode only: rcvd_frame_addr_sapi, revd_frame_addr_tei, 
revd_frame_addr_cr, rcvd_frame_type, rcvd_frame_cntrl_byte_l, 
revd_frame_pf, rcvd_frame_bcc_type, rcvd_frame_nr, and rcvd_frame_ns. 


If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd_frame_type.” 
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Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd_frame_buff_seg, 
revd_frame_sdu_offset, and revd_frame_sdu_size. See Section 66.1 fora 
more detailed discussion of the buffer components to which these variables 
refer. 


Make a pointer to an IL buffer by casting revd_frame_buff_seg as a long, 
shifting it left sixteen bits, adding rcvd_frame_sdu_offset, and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset). 


{ 

unsigned char * ptr; 

ptr = (void *)(({long)revd_frame_buff_ seg << 16) + revd_frame_sdu_offset); 
ptrt=2; : 
) 


It is now pointing at the first byte in the information field. You may 
continue to move through the frame for its entire length, indicated in 
revd_frame_sdu_size. 


Transmit window. Four related variables test the status of the Layer 2 
window. The particular values of these variables at any given time is not 
significant. What is significant is how they compare to each other. The 
softkey status condition on the left makes the variable comparison on the 
right: 


WINDOW FULL 12_current_window_edge == {2_upper_window_edge 
WINDOW EMPTY 12_current_window_edge == 12_lower_window_edge 
WINDOW NOT_FULL i2_current_window_edge != 12_upper_window_edge 
WINDOW NOT_EMPTY i2_current_window_edge /= 12_lower_window_edge 
MORE_TO_RESEND 12_resend_edge != 12_lower_window_edge 


NO_MORE_TO_RESEND 12_resend_edge == 12_lower_window_edge 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /2_enhance or /2_suppress. 
The possible values are listed in Table 80-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
frames in reverse-video and suppress display of invalid frames: 
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CONDITIONS: RCV RNR 
ACTIONS: 


12_enhance = 1; 


} 
CONDITIONS: RCV INVALID 
ACTIONS: 


{ 
f2_suppress = 1; 


Check the value of these display—-control variables in a CONDITIONS block 
CONDITIONS: RCV INFO 
'2_enhance == ] 


} 
ACTIONS; 
{ 


i2_enhance = 0; 


} 
or an ACTIONS block: 


CONDITIONS: RCV INFO 
ACTIONS: 


if(i2_enhance == 1) 
i2_enhance = 0; 


) 


80.3 Routines 
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Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you will be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following will be displayed: “Error 140: Unresolved reference 12_give_data.” 


(A) Receive 
I2_give_ data 
Synopsis 
extern void {2_give_data(); 
Description 
The /2_give_data routine takes an interlayer message buffer associated with a 
received INFO frame, changes the SDU offset to point to higher-level data, and 


sends a DL_DATA IND primitive up to Layer 3 along with a reference to this 
buffer. The softkey equivalent of this routine is the GIVE_DATA action on the 


Protocol Spreadsheet. 
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xampl 


Layer 3 wants access to the line in order to receive and send data. Assuming 
the LAPD personality package is loaded at Layer 2, enter the following program: 


LAYER: 2 

STATE: datalink : 
CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “@DL_DATA))" 
CONDITIONS: RCV INFO 
ACTIONS: 


{ 
i2_give_data(); 


(B) Transmit 


resend_frame 


Synopsis 


extern void resend _frame(pf, first_or_next); 
unsigned char pf; 
unsigned char first_or_next; 


Description 


The resend_frame routine will resend either the first or next frame in the 
window with the P/F bit set to a specified value. The softkey equivalent of this 
routine is the (PROTOCL) RESEND action on the Protocol Spreadsheet. 


Inputs 


The first parameter is the value of the P/F bit in the frame. It may be set to 
either 0 or i. 


The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 
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Example 


Suppose you want to resend the entire transmit window if you receive a REJ 
frame, 


LAYER: 2 
STATE: xfer 
/* Whatever conditions and actlons send data precede the following condition. */ 


CONDITIONS: RCV REJ RESP 
ACTIONS: 


{ 
resend _frame(I, 0); 


) 
NEXT_STATE: recover 
STATE: recover 
CONDITIONS: FRAME_SENT 
MORE_TO_RESEND 
ACTIONS: 


{ 
resend_frame(1,!); 


} 

CONDITIONS: FRAME_SENT 
NO_MORE_TO_RESEND 

NEXT_STATE: xfer 


reset_nr 
nopsi 


extern void reset_nr(); 


Description 


This routine resets the N(R) field in information and supervisory frames to zero. 
The softkey equivalent of this routine is the (PROTOCL) RSET_NR action on the 
Protocol Spreadsheet. 


Example 


When a link is established, reset N(R). 


LAYER: 2 
STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 
{ 
reset_nr(); 


} 
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reset_ns 


nopsi 
extern void reset_ns(); 
Description 
The N(S) field in information frames is reset to zero and the transmit window is 


cleared. The softkey equivalent of this routine is the (PROTOCL) RSET_NS action 
on the Protocol Spreadsheet. 


Example 
When a link is established, reset N(S). 


LAYER: 2 
STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV VA 
ACTIONS: 
{ 
reset_ns(}; 


) 


send_frame 
Synopsis 


extern void send_frame(il_buffer_number, relay_baton, data_start_offset, transmit_frame_ptr); 
unsigned short il_buffer_number; 
unsigned short relay_baton; 
unsigned short data_start_offset; 
struct send_frame_structure 
{ 
unsigned char sapi_type; 
unsigned char tei_type; 
unsigned char cr_type; 
unsigned char frame_type; 
unsigned char nr_type; 
unsigned char ns_type; 
unsigned char p f type; 
unsigned char bcc_type; 
unsigned char sapi_value; 
unsigned char tei_value; 
unsigned char cntri_byte; 
unsigned char nr_value; 
unsigned char ns_value; 
iB 


struct send_frame_structure * transmit_frame_ptr; 


Description 

The send_frame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 
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Inputs 


The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 


The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66,3(A). 


The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). 


The fourth parameter is a pointer to the frame structure to be sent. For a 
description of send_frame_structure see Table 80-1. 


Example 


Send an Info frame containing a canned fox message and a good BCC onto the 
line. 


{ 
Static unsigned short it_buffer_number; 
Static unsigned short relay_baton; 
Static unsigned Short data_start_offset; 
Struct send_frame_structure 
{ 
unsigned char sapi_type; 
unsigned char tei_fype; 
unsigned char cr_type; 
unsigned char frame_type; 
unsigned char nr_type; 
unsigned char ns_type; 
unsigned char p_f type; 
unsigned char bec_type; 
unsigned char sapi_value; 
unsigned char tei_value; 
unsigned char cntri_byte; 
unsigned char nr_value; 
unsigned char ns_value; 
); 
Struct send_frame_structure transmit_frame; 
static char transmit_string [] = “(FOX)”, 
) 
LAYER: 2 
STATE: send_a_ frame 
CONDITIONS: KEYBOARD “ ” 
ACTIONS: 
{ 
_get_il_msg_buff(&il_buffer_number, &relay_baton); 
_start_il_buff_list(il_buffer_number, &data_start_offset); 
transmit_frame. bee_ltype = 1; 
_insert_il_buff_list_ent(it_buffer_number, data_start_offset, &transmit_string{0}, 
(sizeof (transmit_string) - 1)); 
send_frame(il_buffer_number, relay_baton, data_start_offset, &transmit_frame); 


} 
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81 Q.931 Library 


When the Q.931 package is loaded in via the Layer Setup screen, the following external 
variables become available for use by the programmer. Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 3. 


The variables approximate 0.931 Layer 3 spreadsheet-generated conditions and actions. 

Refer to Section 41 for more detailed explanations of the purposes of specific conditions and 
actions. Sometimes the name of the variable is sufficient for identifying its related spreadsheet 
token. When this is not the case, the information is provided below. 


81.1 Structures 


81.2 
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There are no extern structures associated exclusively with Q.931. 


Variables 


The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate—only 
conditions and actions on the Protocol Spreadsheet. 


(A) Monitoring Events 


Q.931 Layer 3 event variables detect packets on either side of the line. See 
Table 81-1. They are valid in either emulate or monitor mode. The event 
variables are dte_packet and dce_packet. 


When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
message type. A DTE INFO condition, for example, when translated, includes two 
C variables, one event variable and one status variable: 


{ 
dte_packet && (m_message type == 0x7b) 


) 


As a C programmer, you do not need to specify a message type. To include all 
DTE messages in a condition, use the event variable only: 


CONDITIONS: 


{ 
die_packet 


) 
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Table 81-1 
Q.931 Variables 


Type Variable Value (hex/decima}) Meaning 
extern event dte_packet True when a DTE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 
extern event dce_packet True when a DCE packet Is 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


m_packet_bec_type 


m_prot_disc 


m_cail_ref_flag 


m_message_type_defined 


00-ff10-255 


(m_message_type_defined continued on next page) 


detected, Line Setup 
configured for emulate or 
monitor mode. 


good 
bad 
abort 


Line Setup configured for 
emulate or monitor mode. 


Actual value of protocol 
discriminator—should be 8, Line 
Setup configured for emulate or 
monitor mode. 


origination side 
destinatlon side 


Line Setup configured for 
emulate or monitor mode. 


Actual value recelved |s not a 
defined value for a LAPD 
message type. 


Actual value recelved Is one of 
the following valid values for a 
LAPD message type: 


1 alerting 

2 call proceeding 
5 setup 

7 connect 
d/13 setup ack 
f/15 connect ack 
20/32 user Info 
21/33 suspend re] 
22/34 resume rej 
25/37 suspend 
26/38 resume 
20/45 suspend ack 
20/46 resume ack 
40/64 detach 
45/69 disconnect 
48/72 detach ack 
4d/77 release 
§a/90 release complete 
60/96 cancel 
62/98 facility 
64/100 register 
68/104 cancel ack 
6a/106 facility ack 


6c/108 register ack 
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Table 81-1 (continued) 


Type Variable Value (hex/decimal) Meaning 


(m_message_type_defined continued) 


é 


extern volatile const unsigned char m_message_type 00-ff/0-255 
extern volatile const unsigned char m_call_ref_len 0-15 
extern volatile const unsigned char m_Info_element_len 


extern volatile const unsigned char * m_ptr_to_call_ref 


extern volatile const unsigned char * m_ptr_to_Info_element 


extern unsigned char I3_ enhance 0 

1 

4 

§ 

8 

9 

12/18 
extern unsigned char 13_ suppress 0 


70/112 cancel re] 

72/114 facllity re| 

74/116 register rej 

79/121 congestion control 
7b/423 info 


70/125 status 


LIne Setup configured for 
emulate or monitor mode. 


Actual value of the 
message-type byte. Line Setup 
configured for emulate or 
monitor mode. 


Length of the call-reference 
value fleld. Line Setup 
configured for emulate or 
monitor mode. 


Length of information element 
field. The total Includes all 
information elements. Line 
Setup configured for emulate or 
monitor mode. 


Pointer to the call-reference 
value fleld. Begins at the first 
byte, contalning the call 
reference length, Line Setup 
configured for emulate or 
monitor mode. 


Pointer to the Information 
element field, Begins at the 
first byte after the 
message-type byte. Line Setup 
configured for emulate or 
monitor mode. 


normal 
reverse 

low 

reverse low 
blink 
reverse blink 
bilnk low 


Line Setup configured for 
emulate or monitor mode. 
off 
on 


Line Setup configured for 
emulate or monitor mode. 
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(B) Status Variables 


Status variables are those in Table 81-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for DTE Info frames is DTE INFO. The C 
version of the same condition should look like this: 


CONDITIONS: 


ape && (m_message_type == 0x7b) 

} \ 

1. Packet characteristics. All status variables in Table 81-1 containing an m_ 
prefix are valid in either emulate or monitor mode: m_packet_bcc_type, 
m_prot_disc, m_call_ref_len, m_call_ref_flag, m_message_type, 
m_message_type_defined, and m_info_element_len. 


2. Pointers. Two pointers provide access to variable-length fields. 
m_pir_to_call_ref is the pointer to the call-reference field. 
m_ptr_to_info_element is the pointer to the information-element field. 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /3_enhance or /3_suppress. 
The values are listed in Table 81-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display 
Suspend messages in reverse-video and suppress display of Status messages: 


CONDITIONS: DTE SUSPEND 
ACTIONS: 


13_enhance = 1; 


) 
CONDITIONS: DTE STATUS 
ACTIONS; 


eae =f; 

) 

Check the value of these display—control variables in a CONDITIONS block 
CONDITIONS: DTE INFO 

!3_enhance == 1] 

eon 

{ 


13_enhance = 0; 


} 
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or an ACTIONS block: 


CONDITIONS: DTE INFO 
ACTIONS: 


if(i3_enhance == /) 
i3_enhance = 0; 


} 


81.3 Routines 


There are no routines associated exclusively with Q.931. 
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82 SS#7 Layer 2 Library 


When the SS#7 Layer 2 package is loaded in via the Layer Setup screen, most of the 
following external variables become available for use by the programmer. Their use on the 
Protocol Spreadsheet is not limited.to any particular layer, though normally they belong at 
Layer 2. 


The SS#7 Layer 1 variables shown in Table 82-2 are accessible only when the Layer 1 
SS7_CMPRESN package is loaded in via the Layer Setup screen. They do not have related 
spreadsheet tokens. These Layer 1 variables are included in this section since they are 
associated with the Layer 2 event variables in Table 82-1. 


The Layer 2 variables approximate SS#7 Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 45 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable is sufficient for identifying its 
related spreadsheet token. When this is not the case, the information is provided below. 


82.1 Structures 


There are no extern structures associated exclusively with SS#7. 


82.2 Variables 


The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 


(A) Monitoring Events 


SS#7 Layer 2 events include frames detected, good or bad BCC’s, and aborts. 
All event variables in Table 82-1 containing a dte_ or dce_ prefix are valid in 
either emulate or monitor mode. These event variables are dte_frame, 
dce_frame, dte_good_bcec, dce_good_bcc, dte_bad_bec, dce_bad_bcc, dte_abort, 
dce_abort. 


You can use both dte and dce variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side of 
the line. Enter the following CONDITIONS/ACTIONS block: 


CONDITIONS: 
dte_bad_bcec || dee_bad_bec 


) 
ACTIONS: COUNTER bad_bece INC 
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Type 


Table 82-1 


SS#7 Layer 2 Variables 


Variable 


Value (hex/decimal) Meaning 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern event 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


dte_frame 


dee_frame 


dte_good_bec 


dce_good_ bcc 


dte_bad_bec 


dce_bad_ bec 


dte_abort 


dce_abort 


m_unit_type 


m_bib 


m_fib 


on 


0 
non-zero 


True when a non-suppressed 
DTE frame Is detected. Line 
Setup configured for emulate or 
monitor mode. 


True when a non-suppressed 
DCE frame Is detected. Line 
Setup conflgured for emulate or 
monitor mode. 


True when a non-suppressed 
good BCC |s calculated for a 
DTE frame. Line Setup 
configured for emulate or 
monitor mode. 


True when a non-suppressed 
good 8CC Is calculated for a 
DCE frame, Line Setup 
configured for emulate or 
monitor mode. 


True when a bad BCC Is 
calculated for a DTE frame. 
Lina Setup configured for 
emulate or monitor mode. 


‘True when a bad BCC Is 


calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 


True when an abort is detected 
for a DTE frame. Line Setup 
configured for emulate or 
monitor mode. 


True when an abort is detected 
for a DCE frame. Line Setup 
conflgured for emulate or 
monitor mode, 


Fill-in Signal Unit (Fi) 
Link Status Signal Unit (LSU) 
Message Signal Unit (MSU) 


Line Setup configured for 
emulate or monitor mode. 


0 
1 


Line Setup configured for 
emulate or monitor mode. 
0 
1 


Line Setup configured for 
emulate or monitor mods. 
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Table 82-1 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile const unsigned char m_ii 


extern volatile const unsigned char m_so0 


extern volatite const unsigned char m_frame_bec_type 


extern unsigned char 


extern unsigned char 


0 Fl 

1-2 LSU 

3-37/63 MSU 
Line Setup configured for 
emulate or monitor mode. 


out of alignment 
normal 
emergency 

out of service 
processor out 
busy 


Line Setup configured for 
emulate or monitor mode. 


MhWNH— & 


good bec 
bad bec 
abort 


Line Setup configured for 
emulate or monitor mode. 


on — 


I2_enhance 0 normal 

1 reverse 

4 low 

5 _ reverse low 
8 blink 

9 reverse blink 
1 


2/18 blink low 


Line Setup configured for 
emulate or monitor mode. 


12_suppress 0 off 
; 1 on 

Line Setup configured for 

emulate or monitor mode. 
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When the user selects OTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular frame 
type. A DTE FILL_IN condition, for example, when translated, includes two C 
variables, one event variable and one status variable: 


{ 
dte_frame && (m_unit_type == 1) 


} 


The C programmer does not need to specify a frame type. To include ail 
frames in a condition, use the event variable only: 


CONDITIONS: 
{ 


dte_frame 
} 
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(B) Status Variables 


Status variables are those in Table 82-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for DTE Busy Link Status Signal Unit is DTE 
STATUS= B. The C version of the same condition should look like this: 


CONDITIONS: 


{ 
die_frame && (m_unit_type == 2) && (m_soO == 5) 
} 


Status variables in Table 82-1 containing an m_ prefix are valid in either emulate 
or monitor mode: m_unit_type, m_bib, m_fib, m_li, m_so0, and 
m_frame_bcc_type. 


The Layer 1 variables listed in Table 82-2 are also status variables, valid in 
either emulate or monitor mode. Any of the Layer 2 event variables in 
Table 82-1 guarantee that they are updated and tested. 


NOTE: The SS#7 Layer 1 variables are updated frequently. If 
you want to track these variables for statistical purposes, we 
recommend that you copy their values into temporary variables. 


(C) Controlling Protocol Trace Display 


To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /2_enhance or 12_suppress. 
The values are listed in Table 82-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
Link Signal Units. Of these, display Emergency LSU’s in reverse—video. 


CONDITIONS: 


{ 
dte_frame && (m_unit_type {= 2) 


} 
ACTIONS: 


{ 
i2_suppress = 1; 


CONDITIONS: 

dte_frame && (m_unit_type == 2) && (m_soO == 2) 
} 

ACTIONS: 

{ 


i2_enhance = 1; 


} 
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Table 82-2 
SS#7 Layer 1 Varlables 


Type Variable Value (hex/decimal) Meaning 


extern unsigned short dte_frames_suppressed Number of OTE Fill-In or Link 
Status Signal Units suppressed 
since the last non-suppressed 
frame, Line Setup configured 
for emulate or monitor mode. 


extern unsigned short dce_frames_suppressed Number of DCE Fill-in or Link 
Status Signal Units suppressed 
since the last non-suppressed 
frame. Line Setup configured 
for emulate or monitor mode. 


extern unsigned short dte_flags Number of DTE flags received 
since the last non-suppressed 
frame. Line Setup configured 
for emulate or monitor mode. 


extern unsigned short dee flags Number of DCE flags recelved 
since the last non-suppressed 
frame, Line Setup configured 
for emulate or monitor mode. 


Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS: 


{ 
dte_frame && (m_unit_type == 2) && (m_soO == 2) && (12_enhance == 0) 


} 
ACTIONS: 
{ 


i2_enhance = 1; 


} 
or an ACTIONS block: 


CONDITIONS: 

{ 

dte_frame && (m_unit_type == 2) && (m_soO == 2) 
} 

ACTIONS: 


{ 
if(l2_enhance == 0) 
{2_enhance = 1; 


} 
82.3 Routines 


There are no routines associated exclusively with SS#7. 
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83 SS#7 Layer 3 Library 


When the SS#7 Layer 3 package is loaded in via the Layer Setup screen, the following 
external variables become available for use by the programmer. Their use on the Protocol 
Spreadsheet is not limited to any particular layer, though normally they belong at Layer 3. 


The variables approximate SS#7 Layer 3 spreadsheet-generated conditions and actions. Refer 
to Section 46 for more detailed explanations of the purposes of specific conditions and 
actions. Sometimes the name of the variable is sufficient for identifying its related spreadsheet 
token. When this is not the case, the information is provided below. 


83.1 Structures 


There are no extern structures associated exclusively with SS#7. 


83.2 Variables 


The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 


(A) Monitoring Events 


SS#7 Layer 3 event variables detect Message Signal Units on either side of the 
line. See Table 83-1. They are valid in either emulate or monitor mode. The 
event variables are dte_packet and dce_packet. 


When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular MSU 
type. A DTE NETM condition, for example, when translated, includes two C 
variables, one event variable and one status variable: 


{ 
dte_packet && (m_sio_si == 0) 


} 


As a C programmer, you do not have to specify an MSU type. To include all 
DTE Message Signal Units in a condition, use the event variable only: 


CONDITIONS: 


{ 
dte_packet 


} 
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Table 83-1 
SS#7 Layer 3 Variables 


Type Variable Value (hex/decimal) Meaning 


extern event dce_packet True when a DCE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 


extern event dte_packet True when a OTE packet Is 
detected, Line Setup 
configured for emulate or 
monitor mode. 


extern volatile const unsigned char m_sio_nl 0 International 0 
40/64 International 1 
80/128 national 0 
c0/192 national 1 


Line Setup configured for 
emulate or monitor mode. 


extern volatile const unsigned char m_slo_priorlity 0 priorlty=0 
10/16 priorlty=1 
20/32 priority=2 
30/48 priority=3 


Line Setup configured for 
emulate or monitor mode. 


extern volatile const unsigned char m_slo_s! 0-7 User Part: 

0 netm 

1 ntr 

2 nts 

3 sccp 

4 tup 

5 Isdn 

6 dupd 

7 dupi 
8-f/8-15 spare 


Line Setup configured for 
emulate or monitor mode. 


extern volatile const unsigned char m_code_type Test headers:f 
{high 4 bits not defined) 
1 Itm 
2 Ita 


(m_code_type continued on next page) 


i EEE SE EEEEEES 


} The high four bits In test headers are not defined. To check the value of m_code_type for test headers, and 
m_code_type with Ox0f: , 


header = m_code_type & Ox0f; 


For LTM's, header equals 1; for LTA’s, header equals 2. 


JUL '90 


83 SS#7 Layer 3 Library 


Table 83-1 (continued) 


Type Variable Value (hex/decimal) Meaning 


(m_code_type continued) 


OOnoMnAWN — 


64/100 
66/102 
76/118 
86/134 


(m_code_type continued on next page) 
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coo 
eco 

ret 

tfp 

rsp (US format only} 
rst (CCITT format only) 
fin 

dic 

coa 

eca 

tfe 

tep (US format only) 
rsr (US format only) 
rst (CCITT format only, national 
option) 

{un 

css 

tfr 

rep (US format only) 
la 

ens 

ter (US format only} 
rer (US format only) 
lua 

cnp 

chd 

tfa 

lid 

cba 

tea (US format only) 
lfu 
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Table 83-1 (continued) 


Type Variable Value (hex/decimal) Meaning 

(m_code_type continued) TUP headers: 
6 anu 
10 reserved 
14/17 lam 
12/18 gsm 
13/19 grq 
14/20 acm 
16/21 sec 
16/22 anc 
17/23 rig 
18/24 mgb 
49/25 cfm 
21/33 fal 
24/36 chg 
25/37 cgc 
26/38 ann 
27/39 blo 
28/40 mba 
29/41 cpm 
31/49 sam 
32/50 cot 
35/53 nne 
36/54 cbk 
37/55 bla 
38/56 mgu 
39/57 cpa 
41/65 sao 
42/66 cof 
45/69 adi 
46/70 clf 
47/71 ubl 
48/72 mua 
49/73 csv 
55/85 cfl 
56/86 ran 
57/87 uba 
58/88 hgb 
§9/89 cvm 
65/101 ssb 
66/102 fot 
67/103 cer 
68/104 hba 
69/105 crm 
75/117 unn 
76/118 col 
77/119 rsc 
78/120 hgu 
79/121 ell 
85/133 los 
88/136 hua 


(m_code_type continued on next page) 
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Table 83-1 (continued) 


Type Variable Value (hex/decimal) Meaning 
(m_code_type continued) (TUP headers continued) 

95/149 sst 
98/152 ars 
a5/165 acb 

* aB/168 gra 
b5/184 dpn 
b8/184 sgb 
05/197 mpr 
08/200 sba 
d8/216 sgu 
08/232 sua 
£5/245 eum 
f6/246 eam 

ISDN headers: 

1 fam 
2 sam 
3 lnr 
4 lnf 
§ cot 
6 aom 
8 fot 
g anm 
a/10 ubm 
b/11 rel 
d/12 pau 
0/14 res 
f/15 risd 
10/16 ric 
11/17 ccr 
12/18 rse 
13/19 blo 
14/20 ubl 
16/21 bla 
16/22 uba 
17/23 ors 
18/24 cegb 
19/25 cqu 
1a/26 cgba 
1b/27 cgua 
10/28 cmr 
1d/29 cme 
106/30 rem 
1f/31 far 
20/32 faa 
21/33 fr} 
22/34 fad 
23/35 fal 
25/37 osvwr 
26/38 csvs 
27/39 drs 
28/40 pam 
29/41 gra 


Line Setup configured for 
emulate or monitor mode, 
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Table 83-1 (continued) 


Type Variable Value (hex/decimal) Meaning 
extern volatile unsigned long m_label_dpc 0-3Hfl 
0-16383 CCITT format (2 bytes) 
O-fffttti 


0-16777215 ANS! format (3 bytes) 
Line Setup configured for 
emulate or monitor mode. 


extern volatile unsigned long m_label- ope 0-3fftl ' 
0-16383 CCITT format {2 bytes) 
O-fftttfi 
0-16777215 ANSI format (3 bytes) 


Line Setup configured for 
emulate or monitor mode. 
extern volatlle const unsigned char m_label_sls 0-f10-15 CCITT format 
- 0-1f10-31 ANS! format 
Line Setup configured for 
emulate or monitor mode, 
extern volatile unsigned short m_ctc 0-1f/0-4095 TUP MSUs 
O-ffff10-65535 ISDN MSUs 
Line Setup configured for 
emulate or monitor mode. 


normal 
reverse 
low 


extern unsigned char 13_enhance 0 
1 
4 
§ reverse low 
8 
9 
1 


blink 
reverse blink 
2/18 blink low 


Line Setup conflgured for 

emulate or monitor mode. 
extern unsigned char I3_suppress 0 off 
a | on 


Line Setup configured for 
emulate or monitor mode. 


sy 


(B) Status Variables 


Status variables are those in Table 83-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 


The softkey-generated condition for NETM Message Signal Units on the DTE 
side of the line is DTE NETM. The C version of the same condition should look 
like this: 


CONDITIONS: 


{ 
dte_packet && (m_sio_si == 0) 


) 
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(Cc 


— 


Most status variables in Table 83-1 contain an m_ prefix: m_sio_ni, 
m_sio_priority, m_sio_si, m_code_type, m_label_dpc, m_label_opc, m_label_sls, 
and m_cic. 


Controlling Protoco! Trace Display 


To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to /3_enhance or /3_suppress. 
The values are listed in Table 83-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
messages with NETM headers. Of these, display Transfer Restricted headers in 
reverse-video. 


CONDITIONS: 

{ 

dte_packet && (m_sio_si [= 0) 
} , 
ACTIONS: 

{ 


13_suppress = 1; 


) 
CONDITIONS: 


{ 
dte_packet && (m_sio_si == 0) && (m_code_type == 0x34) 


} 
ACTIONS: 
{ 


{3_enhance = 1; 


) 


Check the value of these display~control variables in a CONDITIONS block 


CONDITIONS: 


{ 
dte_packet && (m_sio_si != 0) && (l2_suppress == 0) 


} 
ACTIONS: 


{ 
i2_suppress = 1; 


) 


or an ACTIONS block: 


CONDITIONS: 
{ 


dte_packet && (m_sio_si != 0) 
} 

ACTIONS: 

if(t2_suppress == 0) 


i2_suppress = 1; 
) 
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83.3 Routines 


There are no routines associated exclusively with SS#7. 
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